nvme: return string as char *, not unsigned char *
Subsystems (2)
PATCH 1/5 nvme: return string as char *, not unsigned char *
The functions in drivers/nvme/host/constants.c returning human-readable status and opcode strings currently use type "const unsigned char *". Typically string constants use type "const char *",
so remove "unsigned" from the return types.
This is a purely cosmetic change to clarify that the functions return text strings instead of an array of bytes, for example.
--- drivers/nvme/host/constants.c | 8 ++++---- drivers/nvme/host/nvme.h | 18 +++++++++--------- 2 files changed, 13 insertions(+), 13 deletions(-)
drivers/nvme/host/constants.c +4 -4
@@ -169,35 +169,35 @@ static const char * const nvme_statuses[] = { [NVME_SC_CTRL_PATH_ERROR] = "Controller Pathing Error", [NVME_SC_HOST_PATH_ERROR] = "Host Pathing Error", [NVME_SC_HOST_ABORTED_CMD] = "Host Aborted Command", }; -const unsigned char *nvme_get_error_status_str (u16 status) +const char *nvme_get_error_status_str (u16 status) { status &=0x7ff ;if (status <ARRAY_SIZE (nvme_statuses) && nvme_statuses[status])return nvme_statuses[status &0x7ff ];return "Unknown" ; } -const unsigned char *nvme_get_opcode_str (u8 opcode) +const char *nvme_get_opcode_str (u8 opcode) {if (opcode <ARRAY_SIZE (nvme_ops) && nvme_ops[opcode])return nvme_ops[opcode];return "Unknown" ; }EXPORT_SYMBOL_GPL (nvme_get_opcode_str); -const unsigned char *nvme_get_admin_opcode_str (u8 opcode) +const char *nvme_get_admin_opcode_str (u8 opcode) {if (opcode <ARRAY_SIZE (nvme_admin_ops) && nvme_admin_ops[opcode])return nvme_admin_ops[opcode];return "Unknown" ; }EXPORT_SYMBOL_GPL (nvme_get_admin_opcode_str); -const unsigned char *nvme_get_fabrics_opcode_str (u8 opcode) { +const char *nvme_get_fabrics_opcode_str (u8 opcode) {if (opcode <ARRAY_SIZE (nvme_fabrics_ops) && nvme_fabrics_ops[opcode])return nvme_fabrics_ops[opcode];return "Unknown" ; }EXPORT_SYMBOL_GPL (nvme_get_fabrics_opcode_str);
drivers/nvme/host/nvme.h +9 -9
@@ -1123,35 +1123,35 @@ static inline bool nvme_multi_css(struct nvme_ctrl *ctrl) {return (ctrl->ctrl_config &NVME_CC_CSS_MASK ) ==NVME_CC_CSS_CSI ; }#ifdef CONFIG_NVME_VERBOSE_ERRORS -const unsigned char *nvme_get_error_status_str (u16 status); -const unsigned char *nvme_get_opcode_str (u8 opcode); -const unsigned char *nvme_get_admin_opcode_str (u8 opcode); -const unsigned char *nvme_get_fabrics_opcode_str (u8 opcode); +const char *nvme_get_error_status_str (u16 status); +const char *nvme_get_opcode_str (u8 opcode); +const char *nvme_get_admin_opcode_str (u8 opcode); +const char *nvme_get_fabrics_opcode_str (u8 opcode);#else /* CONFIG_NVME_VERBOSE_ERRORS */ -static inline const unsigned char *nvme_get_error_status_str (u16 status) +static inline const char *nvme_get_error_status_str (u16 status) {return "I/O Error" ; } -static inline const unsigned char *nvme_get_opcode_str (u8 opcode) +static inline const char *nvme_get_opcode_str (u8 opcode) {return "I/O Cmd" ; } -static inline const unsigned char *nvme_get_admin_opcode_str (u8 opcode) +static inline const char *nvme_get_admin_opcode_str (u8 opcode) {return "Admin Cmd" ; } -static inline const unsigned char *nvme_get_fabrics_opcode_str (u8 opcode) +static inline const char *nvme_get_fabrics_opcode_str (u8 opcode) {return "Fabrics Cmd" ; }#endif /* CONFIG_NVME_VERBOSE_ERRORS */ -static inline const unsigned char *nvme_opcode_str (int qid,u8 opcode,u8 fctype) +static inline const char *nvme_opcode_str (int qid,u8 opcode,u8 fctype) {if (opcode == nvme_fabrics_command)return nvme_get_fabrics_opcode_str (fctype);return qid ?nvme_get_opcode_str (opcode) :nvme_get_admin_opcode_str (opcode);
Signature · 1 line
2.25.1
PATCH 2/5 nvme: remove redundant status mask
In nvme_get_error_status_str(), the status code is already masked with 0x7ff at the beginning of the function.
Don't bother masking it again when indexing nvme_statuses.
--- drivers/nvme/host/constants.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/nvme/host/constants.c +1 -1
@@ -173,11 +173,11 @@ static const char * const nvme_statuses[] = {const char *nvme_get_error_status_str (u16 status) { status &=0x7ff ;if (status <ARRAY_SIZE (nvme_statuses) && nvme_statuses[status]) -return nvme_statuses[status &0x7ff ]; +return nvme_statuses[status];return "Unknown" ; }const char *nvme_get_opcode_str (u8 opcode) {
Signature · 1 line
2.25.1
Re: [PATCH 2/5] nvme: remove redundant status mask
Looks good:
Re: [PATCH 2/5] nvme: remove redundant status mask
In reply to Caleb SanderPATCH 3/5 nvme: take const cmd pointer in read-only helpers
In reply to Caleb Sandernvme_is_fabrics() and nvme_is_write() only read struct nvme_command, so take it by const pointer. This allows callers to pass a const pointer and communicates that these functions don't modify the command.
--- include/linux/nvme.h | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
include/linux/nvme.h +2 -2
@@ -1810,11 +1810,11 @@ struct nvme_command {struct nvme_dbbuf dbbuf;struct nvme_directive_cmd directive; }; }; -static inline bool nvme_is_fabrics (struct nvme_command *cmd) +static inline bool nvme_is_fabrics (const struct nvme_command *cmd) {return cmd->common.opcode == nvme_fabrics_command; }struct nvme_error_slot {
@@ -1829,11 +1829,11 @@ struct nvme_error_slot {__u8 resv[3 ];__le64 cs;__u8 resv2[24 ]; }; -static inline bool nvme_is_write (struct nvme_command *cmd) +static inline bool nvme_is_write (const struct nvme_command *cmd) {/* * What a mess... * * Why can't we simply have a Fabrics In and Fabrics out command?
Signature · 1 line
2.25.1
Re: [PATCH 3/5] nvme: take const cmd pointer in read-only helpers
Looks good:
Re: [PATCH 3/5] nvme: take const cmd pointer in read-only helpers
In reply to Caleb SanderPATCH 4/5 nvme: split out fabrics version of nvme_opcode_str()
In reply to Caleb Sandernvme_opcode_str() currently supports admin, IO, and fabrics commands. However, fabrics commands aren't allowed for the pci transport. Currently the pci caller passes 0 as the fctype,
which means any fabrics command would be displayed as "Property Set".
Move fabrics command support into a function nvme_fabrics_opcode_str() and remove the fctype argument to nvme_opcode_str().
This way, a fabrics command will display as "Unknown" for pci. Convert the rdma and tcp transports to use nvme_fabrics_opcode_str().
--- drivers/nvme/host/nvme.h | 13 ++++++++++--- drivers/nvme/host/pci.c | 2 +- drivers/nvme/host/rdma.c | 7 +++---- drivers/nvme/host/tcp.c | 6 +++--- 4 files changed, 17 insertions(+), 11 deletions(-)
drivers/nvme/host/nvme.h +10 -3
@@ -1147,13 +1147,20 @@ static inline const char *nvme_get_fabrics_opcode_str(u8 opcode) {return "Fabrics Cmd" ; }#endif /* CONFIG_NVME_VERBOSE_ERRORS */ -static inline const char *nvme_opcode_str (int qid,u8 opcode,u8 fctype) +static inline const char *nvme_opcode_str (int qid,u8 opcode) { -if (opcode == nvme_fabrics_command) -return nvme_get_fabrics_opcode_str (fctype);return qid ?nvme_get_opcode_str (opcode) :nvme_get_admin_opcode_str (opcode); } + +static inline const char *nvme_fabrics_opcode_str ( +int qid,const struct nvme_command *cmd) +{ +if (nvme_is_fabrics (cmd)) +return nvme_get_fabrics_opcode_str (cmd->fabrics.fctype); + +return nvme_opcode_str (qid, cmd->common.opcode); +}#endif /* _NVME_H */
drivers/nvme/host/pci.c +1 -1
@@ -1347,11 +1347,11 @@ static enum blk_eh_timer_return nvme_timeout(struct request *req) opcode =nvme_req (req)->cmd->common.opcode;if (!nvmeq->qid || iod->aborted) {dev_warn (dev->ctrl.device,"I/O tag %d (%04x) opcode %#x (%s) QID %d timeout, reset controller\n" , req->tag,nvme_cid (req), opcode, -nvme_opcode_str (nvmeq->qid, opcode,0 ), nvmeq->qid); +nvme_opcode_str (nvmeq->qid, opcode), nvmeq->qid);nvme_req (req)->flags |=NVME_REQ_CANCELLED ; goto disable; }if (atomic_dec_return (&dev->ctrl.abort_limit) <0 ) {
drivers/nvme/host/rdma.c +3 -4
@@ -1949,18 +1949,17 @@ static void nvme_rdma_complete_timed_out(struct request *rq)static enum blk_eh_timer_return nvme_rdma_timeout (struct request *rq) {struct nvme_rdma_request *req =blk_mq_rq_to_pdu (rq);struct nvme_rdma_queue *queue = req->queue;struct nvme_rdma_ctrl *ctrl = queue->ctrl; -u8 opcode = req->req.cmd->common.opcode; -u8 fctype = req->req.cmd->fabrics.fctype; +struct nvme_command *cmd = req->req.cmd;int qid =nvme_rdma_queue_idx (queue);dev_warn (ctrl->ctrl.device,"I/O tag %d (%04x) opcode %#x (%s) QID %d timeout\n" , - rq->tag,nvme_cid (rq), opcode, -nvme_opcode_str (qid, opcode, fctype), qid); + rq->tag,nvme_cid (rq), cmd->common.opcode, +nvme_fabrics_opcode_str (qid, cmd), qid);if (nvme_ctrl_state (&ctrl->ctrl) !=NVME_CTRL_LIVE ) {/* * If we are resetting, connecting or deleting we should * complete immediately because we may block controller
drivers/nvme/host/tcp.c +3 -3
@@ -2426,17 +2426,17 @@ static void nvme_tcp_complete_timed_out(struct request *rq)static enum blk_eh_timer_return nvme_tcp_timeout (struct request *rq) {struct nvme_tcp_request *req =blk_mq_rq_to_pdu (rq);struct nvme_ctrl *ctrl = &req->queue->ctrl->ctrl;struct nvme_tcp_cmd_pdu *pdu =nvme_tcp_req_cmd_pdu (req); -u8 opc = pdu->cmd.common.opcode, fctype = pdu->cmd.fabrics.fctype; +struct nvme_command *cmd = &pdu->cmd;int qid =nvme_tcp_queue_id (req->queue);dev_warn (ctrl->device,"I/O tag %d (%04x) type %d opcode %#x (%s) QID %d timeout\n" , - rq->tag,nvme_cid (rq), pdu->hdr.type, opc, -nvme_opcode_str (qid, opc, fctype), qid); + rq->tag,nvme_cid (rq), pdu->hdr.type, cmd->common.opcode, +nvme_fabrics_opcode_str (qid, cmd), qid);if (nvme_ctrl_state (ctrl) !=NVME_CTRL_LIVE ) {/* * If we are resetting, connecting or deleting we should * complete immediately because we may block controller
Signature · 1 line
2.25.1
Re: [PATCH 4/5] nvme: split out fabrics version of nvme_opcode_str()
drivers/nvme/host/nvme.h static inline const char *nvme_get_fabrics_opcode_str(u8 opcode) · line 1159
Quoted 2 lines
drivers/nvme/host/nvme.h +2
-0+static inline const char *nvme_fabrics_opcode_str ( +int qid,const struct nvme_command *cmd)
Nit: We use two-tab (or aligned to opening brace) alignment for line continuations, and the qid still fits onto the first line:
static inline const char *nvme_fabrics_opcode_str(int qid,
const struct nvme_command *cmd)
Otherwise looks good:
Re: [PATCH 4/5] nvme: split out fabrics version of nvme_opcode_str()
In reply to Caleb SanderPATCH 5/5 nvme-fc: log human-readable opcode on timeout
In reply to Caleb SanderThe fc transport logs the opcode and fctype on command timeout. This is sufficient information to identify the command issued, but not very human-readable. Use the nvme_fabrics_opcode_str() helper to also log the name of the command, as rdma and tcp already do.
--- drivers/nvme/host/fc.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-)
drivers/nvme/host/fc.c +5 -3
@@ -2572,22 +2572,24 @@ nvme_fc_error_recovery(struct nvme_fc_ctrl *ctrl, char *errmsg)static enum blk_eh_timer_return nvme_fc_timeout (struct request *rq) {struct nvme_fc_fcp_op *op =blk_mq_rq_to_pdu (rq);struct nvme_fc_ctrl *ctrl = op->ctrl; +u16 qnum = op->queue->qnum;struct nvme_fc_cmd_iu *cmdiu = &op->cmd_iu;struct nvme_command *sqe = &cmdiu->sqe;/* * Attempt to abort the offending command. Command completion * will detect the aborted io and will fail the connection. */ dev_info (ctrl->ctrl.device, -"NVME-FC{%d.%d}: io timeout: opcode %d fctype %d w10/11: " +"NVME-FC{%d.%d}: io timeout: opcode %d fctype %d (%s) w10/11: " "x%08x/x%08x\n" , - ctrl->cnum, op->queue->qnum, sqe->common.opcode, - sqe->connect.fctype, sqe->common.cdw10, sqe->common.cdw11); + ctrl->cnum, qnum, sqe->common.opcode, sqe->fabrics.fctype, +nvme_fabrics_opcode_str (qnum, sqe), + sqe->common.cdw10, sqe->common.cdw11);if (__nvme_fc_abort_op (ctrl, op))nvme_fc_error_recovery (ctrl,"io timeout abort failed" );/* * the io abort has been initiated. Have the reset timer
Signature · 1 line
2.25.1
Re: [PATCH 5/5] nvme-fc: log human-readable opcode on timeout
Looks good:
Re: [PATCH 5/5] nvme-fc: log human-readable opcode on timeout
In reply to Caleb SanderLooks good:
Quoted 10 lines · Caleb Sander
The functions in
drivers/nvme/host/constants.creturning human-readable status and opcode strings currently use type "const unsigned char *". Typically string constants use type "const char *",
so remove "unsigned" from the return types.
This is a purely cosmetic change to clarify that the functions return text strings instead of an array of bytes, for example.Signed-off-by Caleb Sander <[email protected]>---
looks good, for the entire series :-
-ck
Thanks, applied to nvme-6.8.