1 /*- 2 * BSD LICENSE 3 * 4 * Copyright (c) Intel Corporation. 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 11 * * Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * * Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in 15 * the documentation and/or other materials provided with the 16 * distribution. 17 * * Neither the name of Intel Corporation nor the names of its 18 * contributors may be used to endorse or promote products derived 19 * from this software without specific prior written permission. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 */ 33 34 #include "nvme_internal.h" 35 #include "spdk/nvme_ocssd.h" 36 37 static void nvme_qpair_fail(struct spdk_nvme_qpair *qpair); 38 39 struct nvme_string { 40 uint16_t value; 41 const char *str; 42 }; 43 44 static const struct nvme_string admin_opcode[] = { 45 { SPDK_NVME_OPC_DELETE_IO_SQ, "DELETE IO SQ" }, 46 { SPDK_NVME_OPC_CREATE_IO_SQ, "CREATE IO SQ" }, 47 { SPDK_NVME_OPC_GET_LOG_PAGE, "GET LOG PAGE" }, 48 { SPDK_NVME_OPC_DELETE_IO_CQ, "DELETE IO CQ" }, 49 { SPDK_NVME_OPC_CREATE_IO_CQ, "CREATE IO CQ" }, 50 { SPDK_NVME_OPC_IDENTIFY, "IDENTIFY" }, 51 { SPDK_NVME_OPC_ABORT, "ABORT" }, 52 { SPDK_NVME_OPC_SET_FEATURES, "SET FEATURES" }, 53 { SPDK_NVME_OPC_GET_FEATURES, "GET FEATURES" }, 54 { SPDK_NVME_OPC_ASYNC_EVENT_REQUEST, "ASYNC EVENT REQUEST" }, 55 { SPDK_NVME_OPC_NS_MANAGEMENT, "NAMESPACE MANAGEMENT" }, 56 { SPDK_NVME_OPC_FIRMWARE_COMMIT, "FIRMWARE COMMIT" }, 57 { SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD, "FIRMWARE IMAGE DOWNLOAD" }, 58 { SPDK_NVME_OPC_DEVICE_SELF_TEST, "DEVICE SELF-TEST" }, 59 { SPDK_NVME_OPC_NS_ATTACHMENT, "NAMESPACE ATTACHMENT" }, 60 { SPDK_NVME_OPC_KEEP_ALIVE, "KEEP ALIVE" }, 61 { SPDK_NVME_OPC_DIRECTIVE_SEND, "DIRECTIVE SEND" }, 62 { SPDK_NVME_OPC_DIRECTIVE_RECEIVE, "DIRECTIVE RECEIVE" }, 63 { SPDK_NVME_OPC_VIRTUALIZATION_MANAGEMENT, "VIRTUALIZATION MANAGEMENT" }, 64 { SPDK_NVME_OPC_NVME_MI_SEND, "NVME-MI SEND" }, 65 { SPDK_NVME_OPC_NVME_MI_RECEIVE, "NVME-MI RECEIVE" }, 66 { SPDK_NVME_OPC_DOORBELL_BUFFER_CONFIG, "DOORBELL BUFFER CONFIG" }, 67 { SPDK_NVME_OPC_FORMAT_NVM, "FORMAT NVM" }, 68 { SPDK_NVME_OPC_SECURITY_SEND, "SECURITY SEND" }, 69 { SPDK_NVME_OPC_SECURITY_RECEIVE, "SECURITY RECEIVE" }, 70 { SPDK_NVME_OPC_SANITIZE, "SANITIZE" }, 71 { SPDK_OCSSD_OPC_GEOMETRY, "OCSSD / GEOMETRY" }, 72 { 0xFFFF, "ADMIN COMMAND" } 73 }; 74 75 static const struct nvme_string io_opcode[] = { 76 { SPDK_NVME_OPC_FLUSH, "FLUSH" }, 77 { SPDK_NVME_OPC_WRITE, "WRITE" }, 78 { SPDK_NVME_OPC_READ, "READ" }, 79 { SPDK_NVME_OPC_WRITE_UNCORRECTABLE, "WRITE UNCORRECTABLE" }, 80 { SPDK_NVME_OPC_COMPARE, "COMPARE" }, 81 { SPDK_NVME_OPC_WRITE_ZEROES, "WRITE ZEROES" }, 82 { SPDK_NVME_OPC_DATASET_MANAGEMENT, "DATASET MANAGEMENT" }, 83 { SPDK_NVME_OPC_RESERVATION_REGISTER, "RESERVATION REGISTER" }, 84 { SPDK_NVME_OPC_RESERVATION_REPORT, "RESERVATION REPORT" }, 85 { SPDK_NVME_OPC_RESERVATION_ACQUIRE, "RESERVATION ACQUIRE" }, 86 { SPDK_NVME_OPC_RESERVATION_RELEASE, "RESERVATION RELEASE" }, 87 { SPDK_OCSSD_OPC_VECTOR_RESET, "OCSSD / VECTOR RESET" }, 88 { SPDK_OCSSD_OPC_VECTOR_WRITE, "OCSSD / VECTOR WRITE" }, 89 { SPDK_OCSSD_OPC_VECTOR_READ, "OCSSD / VECTOR READ" }, 90 { SPDK_OCSSD_OPC_VECTOR_COPY, "OCSSD / VECTOR COPY" }, 91 { 0xFFFF, "IO COMMAND" } 92 }; 93 94 static const char * 95 nvme_get_string(const struct nvme_string *strings, uint16_t value) 96 { 97 const struct nvme_string *entry; 98 99 entry = strings; 100 101 while (entry->value != 0xFFFF) { 102 if (entry->value == value) { 103 return entry->str; 104 } 105 entry++; 106 } 107 return entry->str; 108 } 109 110 static void 111 nvme_admin_qpair_print_command(struct spdk_nvme_qpair *qpair, 112 struct spdk_nvme_cmd *cmd) 113 { 114 115 SPDK_NOTICELOG("%s (%02x) sqid:%d cid:%d nsid:%x " 116 "cdw10:%08x cdw11:%08x\n", 117 nvme_get_string(admin_opcode, cmd->opc), cmd->opc, qpair->id, cmd->cid, 118 cmd->nsid, cmd->cdw10, cmd->cdw11); 119 } 120 121 static void 122 nvme_io_qpair_print_command(struct spdk_nvme_qpair *qpair, 123 struct spdk_nvme_cmd *cmd) 124 { 125 assert(qpair != NULL); 126 assert(cmd != NULL); 127 switch ((int)cmd->opc) { 128 case SPDK_NVME_OPC_WRITE: 129 case SPDK_NVME_OPC_READ: 130 case SPDK_NVME_OPC_WRITE_UNCORRECTABLE: 131 case SPDK_NVME_OPC_COMPARE: 132 SPDK_NOTICELOG("%s sqid:%d cid:%d nsid:%d " 133 "lba:%llu len:%d\n", 134 nvme_get_string(io_opcode, cmd->opc), qpair->id, cmd->cid, 135 cmd->nsid, 136 ((unsigned long long)cmd->cdw11 << 32) + cmd->cdw10, 137 (cmd->cdw12 & 0xFFFF) + 1); 138 break; 139 case SPDK_NVME_OPC_FLUSH: 140 case SPDK_NVME_OPC_DATASET_MANAGEMENT: 141 SPDK_NOTICELOG("%s sqid:%d cid:%d nsid:%d\n", 142 nvme_get_string(io_opcode, cmd->opc), qpair->id, cmd->cid, 143 cmd->nsid); 144 break; 145 default: 146 SPDK_NOTICELOG("%s (%02x) sqid:%d cid:%d nsid:%d\n", 147 nvme_get_string(io_opcode, cmd->opc), cmd->opc, qpair->id, 148 cmd->cid, cmd->nsid); 149 break; 150 } 151 } 152 153 void 154 nvme_qpair_print_command(struct spdk_nvme_qpair *qpair, struct spdk_nvme_cmd *cmd) 155 { 156 assert(qpair != NULL); 157 assert(cmd != NULL); 158 159 if (nvme_qpair_is_admin_queue(qpair)) { 160 nvme_admin_qpair_print_command(qpair, cmd); 161 } else { 162 nvme_io_qpair_print_command(qpair, cmd); 163 } 164 } 165 166 static const struct nvme_string generic_status[] = { 167 { SPDK_NVME_SC_SUCCESS, "SUCCESS" }, 168 { SPDK_NVME_SC_INVALID_OPCODE, "INVALID OPCODE" }, 169 { SPDK_NVME_SC_INVALID_FIELD, "INVALID FIELD" }, 170 { SPDK_NVME_SC_COMMAND_ID_CONFLICT, "COMMAND ID CONFLICT" }, 171 { SPDK_NVME_SC_DATA_TRANSFER_ERROR, "DATA TRANSFER ERROR" }, 172 { SPDK_NVME_SC_ABORTED_POWER_LOSS, "ABORTED - POWER LOSS" }, 173 { SPDK_NVME_SC_INTERNAL_DEVICE_ERROR, "INTERNAL DEVICE ERROR" }, 174 { SPDK_NVME_SC_ABORTED_BY_REQUEST, "ABORTED - BY REQUEST" }, 175 { SPDK_NVME_SC_ABORTED_SQ_DELETION, "ABORTED - SQ DELETION" }, 176 { SPDK_NVME_SC_ABORTED_FAILED_FUSED, "ABORTED - FAILED FUSED" }, 177 { SPDK_NVME_SC_ABORTED_MISSING_FUSED, "ABORTED - MISSING FUSED" }, 178 { SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT, "INVALID NAMESPACE OR FORMAT" }, 179 { SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR, "COMMAND SEQUENCE ERROR" }, 180 { SPDK_NVME_SC_INVALID_SGL_SEG_DESCRIPTOR, "INVALID SGL SEGMENT DESCRIPTOR" }, 181 { SPDK_NVME_SC_INVALID_NUM_SGL_DESCIRPTORS, "INVALID NUMBER OF SGL DESCRIPTORS" }, 182 { SPDK_NVME_SC_DATA_SGL_LENGTH_INVALID, "DATA SGL LENGTH INVALID" }, 183 { SPDK_NVME_SC_METADATA_SGL_LENGTH_INVALID, "METADATA SGL LENGTH INVALID" }, 184 { SPDK_NVME_SC_SGL_DESCRIPTOR_TYPE_INVALID, "SGL DESCRIPTOR TYPE INVALID" }, 185 { SPDK_NVME_SC_INVALID_CONTROLLER_MEM_BUF, "INVALID CONTROLLER MEMORY BUFFER" }, 186 { SPDK_NVME_SC_INVALID_PRP_OFFSET, "INVALID PRP OFFSET" }, 187 { SPDK_NVME_SC_ATOMIC_WRITE_UNIT_EXCEEDED, "ATOMIC WRITE UNIT EXCEEDED" }, 188 { SPDK_NVME_SC_OPERATION_DENIED, "OPERATION DENIED" }, 189 { SPDK_NVME_SC_INVALID_SGL_OFFSET, "INVALID SGL OFFSET" }, 190 { SPDK_NVME_SC_HOSTID_INCONSISTENT_FORMAT, "HOSTID INCONSISTENT FORMAT" }, 191 { SPDK_NVME_SC_KEEP_ALIVE_EXPIRED, "KEEP ALIVE EXPIRED" }, 192 { SPDK_NVME_SC_KEEP_ALIVE_INVALID, "KEEP ALIVE INVALID" }, 193 { SPDK_NVME_SC_ABORTED_PREEMPT, "ABORTED - PREEMPT AND ABORT" }, 194 { SPDK_NVME_SC_SANITIZE_FAILED, "SANITIZE FAILED" }, 195 { SPDK_NVME_SC_SANITIZE_IN_PROGRESS, "SANITIZE IN PROGRESS" }, 196 { SPDK_NVME_SC_SGL_DATA_BLOCK_GRANULARITY_INVALID, "DATA BLOCK GRANULARITY INVALID" }, 197 { SPDK_NVME_SC_COMMAND_INVALID_IN_CMB, "COMMAND NOT SUPPORTED FOR QUEUE IN CMB" }, 198 { SPDK_NVME_SC_LBA_OUT_OF_RANGE, "LBA OUT OF RANGE" }, 199 { SPDK_NVME_SC_CAPACITY_EXCEEDED, "CAPACITY EXCEEDED" }, 200 { SPDK_NVME_SC_NAMESPACE_NOT_READY, "NAMESPACE NOT READY" }, 201 { SPDK_NVME_SC_RESERVATION_CONFLICT, "RESERVATION CONFLICT" }, 202 { SPDK_NVME_SC_FORMAT_IN_PROGRESS, "FORMAT IN PROGRESS" }, 203 { 0xFFFF, "GENERIC" } 204 }; 205 206 static const struct nvme_string command_specific_status[] = { 207 { SPDK_NVME_SC_COMPLETION_QUEUE_INVALID, "INVALID COMPLETION QUEUE" }, 208 { SPDK_NVME_SC_INVALID_QUEUE_IDENTIFIER, "INVALID QUEUE IDENTIFIER" }, 209 { SPDK_NVME_SC_MAXIMUM_QUEUE_SIZE_EXCEEDED, "MAX QUEUE SIZE EXCEEDED" }, 210 { SPDK_NVME_SC_ABORT_COMMAND_LIMIT_EXCEEDED, "ABORT CMD LIMIT EXCEEDED" }, 211 { SPDK_NVME_SC_ASYNC_EVENT_REQUEST_LIMIT_EXCEEDED, "ASYNC LIMIT EXCEEDED" }, 212 { SPDK_NVME_SC_INVALID_FIRMWARE_SLOT, "INVALID FIRMWARE SLOT" }, 213 { SPDK_NVME_SC_INVALID_FIRMWARE_IMAGE, "INVALID FIRMWARE IMAGE" }, 214 { SPDK_NVME_SC_INVALID_INTERRUPT_VECTOR, "INVALID INTERRUPT VECTOR" }, 215 { SPDK_NVME_SC_INVALID_LOG_PAGE, "INVALID LOG PAGE" }, 216 { SPDK_NVME_SC_INVALID_FORMAT, "INVALID FORMAT" }, 217 { SPDK_NVME_SC_FIRMWARE_REQ_CONVENTIONAL_RESET, "FIRMWARE REQUIRES CONVENTIONAL RESET" }, 218 { SPDK_NVME_SC_INVALID_QUEUE_DELETION, "INVALID QUEUE DELETION" }, 219 { SPDK_NVME_SC_FEATURE_ID_NOT_SAVEABLE, "FEATURE ID NOT SAVEABLE" }, 220 { SPDK_NVME_SC_FEATURE_NOT_CHANGEABLE, "FEATURE NOT CHANGEABLE" }, 221 { SPDK_NVME_SC_FEATURE_NOT_NAMESPACE_SPECIFIC, "FEATURE NOT NAMESPACE SPECIFIC" }, 222 { SPDK_NVME_SC_FIRMWARE_REQ_NVM_RESET, "FIRMWARE REQUIRES NVM RESET" }, 223 { SPDK_NVME_SC_FIRMWARE_REQ_RESET, "FIRMWARE REQUIRES RESET" }, 224 { SPDK_NVME_SC_FIRMWARE_REQ_MAX_TIME_VIOLATION, "FIRMWARE REQUIRES MAX TIME VIOLATION" }, 225 { SPDK_NVME_SC_FIRMWARE_ACTIVATION_PROHIBITED, "FIRMWARE ACTIVATION PROHIBITED" }, 226 { SPDK_NVME_SC_OVERLAPPING_RANGE, "OVERLAPPING RANGE" }, 227 { SPDK_NVME_SC_NAMESPACE_INSUFFICIENT_CAPACITY, "NAMESPACE INSUFFICIENT CAPACITY" }, 228 { SPDK_NVME_SC_NAMESPACE_ID_UNAVAILABLE, "NAMESPACE ID UNAVAILABLE" }, 229 { SPDK_NVME_SC_NAMESPACE_ALREADY_ATTACHED, "NAMESPACE ALREADY ATTACHED" }, 230 { SPDK_NVME_SC_NAMESPACE_IS_PRIVATE, "NAMESPACE IS PRIVATE" }, 231 { SPDK_NVME_SC_NAMESPACE_NOT_ATTACHED, "NAMESPACE NOT ATTACHED" }, 232 { SPDK_NVME_SC_THINPROVISIONING_NOT_SUPPORTED, "THINPROVISIONING NOT SUPPORTED" }, 233 { SPDK_NVME_SC_CONTROLLER_LIST_INVALID, "CONTROLLER LIST INVALID" }, 234 { SPDK_NVME_SC_DEVICE_SELF_TEST_IN_PROGRESS, "DEVICE SELF-TEST IN PROGRESS" }, 235 { SPDK_NVME_SC_BOOT_PARTITION_WRITE_PROHIBITED, "BOOT PARTITION WRITE PROHIBITED" }, 236 { SPDK_NVME_SC_INVALID_CTRLR_ID, "INVALID CONTROLLER ID" }, 237 { SPDK_NVME_SC_INVALID_SECONDARY_CTRLR_STATE, "INVALID SECONDARY CONTROLLER STATE" }, 238 { SPDK_NVME_SC_INVALID_NUM_CTRLR_RESOURCES, "INVALID NUMBER OF CONTROLLER RESOURCES" }, 239 { SPDK_NVME_SC_INVALID_RESOURCE_ID, "INVALID RESOURCE IDENTIFIER" }, 240 { SPDK_NVME_SC_CONFLICTING_ATTRIBUTES, "CONFLICTING ATTRIBUTES" }, 241 { SPDK_NVME_SC_INVALID_PROTECTION_INFO, "INVALID PROTECTION INFO" }, 242 { SPDK_NVME_SC_ATTEMPTED_WRITE_TO_RO_PAGE, "WRITE TO RO PAGE" }, 243 { 0xFFFF, "COMMAND SPECIFIC" } 244 }; 245 246 static const struct nvme_string media_error_status[] = { 247 { SPDK_NVME_SC_WRITE_FAULTS, "WRITE FAULTS" }, 248 { SPDK_NVME_SC_UNRECOVERED_READ_ERROR, "UNRECOVERED READ ERROR" }, 249 { SPDK_NVME_SC_GUARD_CHECK_ERROR, "GUARD CHECK ERROR" }, 250 { SPDK_NVME_SC_APPLICATION_TAG_CHECK_ERROR, "APPLICATION TAG CHECK ERROR" }, 251 { SPDK_NVME_SC_REFERENCE_TAG_CHECK_ERROR, "REFERENCE TAG CHECK ERROR" }, 252 { SPDK_NVME_SC_COMPARE_FAILURE, "COMPARE FAILURE" }, 253 { SPDK_NVME_SC_ACCESS_DENIED, "ACCESS DENIED" }, 254 { SPDK_NVME_SC_DEALLOCATED_OR_UNWRITTEN_BLOCK, "DEALLOCATED OR UNWRITTEN BLOCK" }, 255 { SPDK_OCSSD_SC_OFFLINE_CHUNK, "RESET OFFLINE CHUNK" }, 256 { SPDK_OCSSD_SC_INVALID_RESET, "INVALID RESET" }, 257 { SPDK_OCSSD_SC_WRITE_FAIL_WRITE_NEXT_UNIT, "WRITE FAIL WRITE NEXT UNIT" }, 258 { SPDK_OCSSD_SC_WRITE_FAIL_CHUNK_EARLY_CLOSE, "WRITE FAIL CHUNK EARLY CLOSE" }, 259 { SPDK_OCSSD_SC_OUT_OF_ORDER_WRITE, "OUT OF ORDER WRITE" }, 260 { SPDK_OCSSD_SC_READ_HIGH_ECC, "READ HIGH ECC" }, 261 { 0xFFFF, "MEDIA ERROR" } 262 }; 263 264 static const struct nvme_string path_status[] = { 265 { SPDK_NVME_SC_INTERNAL_PATH_ERROR, "INTERNAL PATH ERROR" }, 266 { SPDK_NVME_SC_CONTROLLER_PATH_ERROR, "CONTROLLER PATH ERROR" }, 267 { SPDK_NVME_SC_HOST_PATH_ERROR, "HOST PATH ERROR" }, 268 { SPDK_NVME_SC_ABORTED_BY_HOST, "ABORTED BY HOST" }, 269 { 0xFFFF, "PATH ERROR" } 270 }; 271 272 const char * 273 spdk_nvme_cpl_get_status_string(const struct spdk_nvme_status *status) 274 { 275 const struct nvme_string *entry; 276 277 switch (status->sct) { 278 case SPDK_NVME_SCT_GENERIC: 279 entry = generic_status; 280 break; 281 case SPDK_NVME_SCT_COMMAND_SPECIFIC: 282 entry = command_specific_status; 283 break; 284 case SPDK_NVME_SCT_MEDIA_ERROR: 285 entry = media_error_status; 286 break; 287 case SPDK_NVME_SCT_PATH: 288 entry = path_status; 289 break; 290 case SPDK_NVME_SCT_VENDOR_SPECIFIC: 291 return "VENDOR SPECIFIC"; 292 default: 293 return "RESERVED"; 294 } 295 296 return nvme_get_string(entry, status->sc); 297 } 298 299 void 300 nvme_qpair_print_completion(struct spdk_nvme_qpair *qpair, 301 struct spdk_nvme_cpl *cpl) 302 { 303 SPDK_NOTICELOG("%s (%02x/%02x) sqid:%d cid:%d cdw0:%x sqhd:%04x p:%x m:%x dnr:%x\n", 304 spdk_nvme_cpl_get_status_string(&cpl->status), 305 cpl->status.sct, cpl->status.sc, cpl->sqid, cpl->cid, cpl->cdw0, 306 cpl->sqhd, cpl->status.p, cpl->status.m, cpl->status.dnr); 307 } 308 309 bool 310 nvme_completion_is_retry(const struct spdk_nvme_cpl *cpl) 311 { 312 /* 313 * TODO: spec is not clear how commands that are aborted due 314 * to TLER will be marked. So for now, it seems 315 * NAMESPACE_NOT_READY is the only case where we should 316 * look at the DNR bit. 317 */ 318 switch ((int)cpl->status.sct) { 319 case SPDK_NVME_SCT_GENERIC: 320 switch ((int)cpl->status.sc) { 321 case SPDK_NVME_SC_NAMESPACE_NOT_READY: 322 case SPDK_NVME_SC_FORMAT_IN_PROGRESS: 323 if (cpl->status.dnr) { 324 return false; 325 } else { 326 return true; 327 } 328 case SPDK_NVME_SC_INVALID_OPCODE: 329 case SPDK_NVME_SC_INVALID_FIELD: 330 case SPDK_NVME_SC_COMMAND_ID_CONFLICT: 331 case SPDK_NVME_SC_DATA_TRANSFER_ERROR: 332 case SPDK_NVME_SC_ABORTED_POWER_LOSS: 333 case SPDK_NVME_SC_INTERNAL_DEVICE_ERROR: 334 case SPDK_NVME_SC_ABORTED_BY_REQUEST: 335 case SPDK_NVME_SC_ABORTED_SQ_DELETION: 336 case SPDK_NVME_SC_ABORTED_FAILED_FUSED: 337 case SPDK_NVME_SC_ABORTED_MISSING_FUSED: 338 case SPDK_NVME_SC_INVALID_NAMESPACE_OR_FORMAT: 339 case SPDK_NVME_SC_COMMAND_SEQUENCE_ERROR: 340 case SPDK_NVME_SC_LBA_OUT_OF_RANGE: 341 case SPDK_NVME_SC_CAPACITY_EXCEEDED: 342 default: 343 return false; 344 } 345 case SPDK_NVME_SCT_PATH: 346 /* 347 * Per NVMe TP 4028 (Path and Transport Error Enhancements), retries should be 348 * based on the setting of the DNR bit for Internal Path Error 349 */ 350 switch ((int)cpl->status.sc) { 351 case SPDK_NVME_SC_INTERNAL_PATH_ERROR: 352 return !cpl->status.dnr; 353 default: 354 return false; 355 } 356 case SPDK_NVME_SCT_COMMAND_SPECIFIC: 357 case SPDK_NVME_SCT_MEDIA_ERROR: 358 case SPDK_NVME_SCT_VENDOR_SPECIFIC: 359 default: 360 return false; 361 } 362 } 363 364 static void 365 nvme_qpair_manual_complete_request(struct spdk_nvme_qpair *qpair, 366 struct nvme_request *req, uint32_t sct, uint32_t sc, 367 bool print_on_error) 368 { 369 struct spdk_nvme_cpl cpl; 370 bool error; 371 372 memset(&cpl, 0, sizeof(cpl)); 373 cpl.sqid = qpair->id; 374 cpl.status.sct = sct; 375 cpl.status.sc = sc; 376 377 error = spdk_nvme_cpl_is_error(&cpl); 378 379 if (error && print_on_error) { 380 SPDK_NOTICELOG("Command completed manually:\n"); 381 nvme_qpair_print_command(qpair, &req->cmd); 382 nvme_qpair_print_completion(qpair, &cpl); 383 } 384 385 nvme_complete_request(req->cb_fn, req->cb_arg, req, &cpl); 386 nvme_free_request(req); 387 } 388 389 int32_t 390 spdk_nvme_qpair_process_completions(struct spdk_nvme_qpair *qpair, uint32_t max_completions) 391 { 392 int32_t ret; 393 struct nvme_request *req, *tmp; 394 395 if (qpair->ctrlr->is_failed) { 396 nvme_qpair_fail(qpair); 397 return 0; 398 } 399 400 /* error injection for those queued error requests */ 401 if (spdk_unlikely(!STAILQ_EMPTY(&qpair->err_req_head))) { 402 STAILQ_FOREACH_SAFE(req, &qpair->err_req_head, stailq, tmp) { 403 if (spdk_get_ticks() - req->submit_tick > req->timeout_tsc) { 404 STAILQ_REMOVE(&qpair->err_req_head, req, nvme_request, stailq); 405 nvme_qpair_manual_complete_request(qpair, req, 406 req->cpl.status.sct, 407 req->cpl.status.sc, true); 408 } 409 } 410 } 411 412 qpair->in_completion_context = 1; 413 ret = nvme_transport_qpair_process_completions(qpair, max_completions); 414 qpair->in_completion_context = 0; 415 if (qpair->delete_after_completion_context) { 416 /* 417 * A request to delete this qpair was made in the context of this completion 418 * routine - so it is safe to delete it now. 419 */ 420 spdk_nvme_ctrlr_free_io_qpair(qpair); 421 } 422 return ret; 423 } 424 425 int 426 nvme_qpair_init(struct spdk_nvme_qpair *qpair, uint16_t id, 427 struct spdk_nvme_ctrlr *ctrlr, 428 enum spdk_nvme_qprio qprio, 429 uint32_t num_requests) 430 { 431 size_t req_size_padded; 432 uint32_t i; 433 434 qpair->id = id; 435 qpair->qprio = qprio; 436 437 qpair->in_completion_context = 0; 438 qpair->delete_after_completion_context = 0; 439 qpair->no_deletion_notification_needed = 0; 440 441 qpair->ctrlr = ctrlr; 442 qpair->trtype = ctrlr->trid.trtype; 443 444 STAILQ_INIT(&qpair->free_req); 445 STAILQ_INIT(&qpair->queued_req); 446 TAILQ_INIT(&qpair->err_cmd_head); 447 STAILQ_INIT(&qpair->err_req_head); 448 449 req_size_padded = (sizeof(struct nvme_request) + 63) & ~(size_t)63; 450 451 qpair->req_buf = spdk_zmalloc(req_size_padded * num_requests, 64, NULL, 452 SPDK_ENV_SOCKET_ID_ANY, SPDK_MALLOC_SHARE); 453 if (qpair->req_buf == NULL) { 454 SPDK_ERRLOG("no memory to allocate qpair(cntlid:0x%x sqid:%d) req_buf with %d request\n", 455 ctrlr->cntlid, qpair->id, num_requests); 456 return -ENOMEM; 457 } 458 459 for (i = 0; i < num_requests; i++) { 460 struct nvme_request *req = qpair->req_buf + i * req_size_padded; 461 462 STAILQ_INSERT_HEAD(&qpair->free_req, req, stailq); 463 } 464 465 return 0; 466 } 467 468 void 469 nvme_qpair_deinit(struct spdk_nvme_qpair *qpair) 470 { 471 struct nvme_request *req; 472 struct nvme_error_cmd *cmd, *entry; 473 474 while (!STAILQ_EMPTY(&qpair->err_req_head)) { 475 req = STAILQ_FIRST(&qpair->err_req_head); 476 STAILQ_REMOVE_HEAD(&qpair->err_req_head, stailq); 477 nvme_qpair_manual_complete_request(qpair, req, 478 req->cpl.status.sct, 479 req->cpl.status.sc, true); 480 } 481 482 TAILQ_FOREACH_SAFE(cmd, &qpair->err_cmd_head, link, entry) { 483 TAILQ_REMOVE(&qpair->err_cmd_head, cmd, link); 484 spdk_dma_free(cmd); 485 } 486 487 spdk_dma_free(qpair->req_buf); 488 } 489 490 int 491 nvme_qpair_submit_request(struct spdk_nvme_qpair *qpair, struct nvme_request *req) 492 { 493 int rc = 0; 494 struct nvme_request *child_req, *tmp; 495 struct nvme_error_cmd *cmd; 496 struct spdk_nvme_ctrlr *ctrlr = qpair->ctrlr; 497 bool child_req_failed = false; 498 499 if (ctrlr->is_failed) { 500 nvme_free_request(req); 501 return -ENXIO; 502 } 503 504 if (req->num_children) { 505 /* 506 * This is a split (parent) request. Submit all of the children but not the parent 507 * request itself, since the parent is the original unsplit request. 508 */ 509 TAILQ_FOREACH_SAFE(child_req, &req->children, child_tailq, tmp) { 510 if (!child_req_failed) { 511 rc = nvme_qpair_submit_request(qpair, child_req); 512 if (rc != 0) { 513 child_req_failed = true; 514 } 515 } else { /* free remaining child_reqs since one child_req fails */ 516 nvme_request_remove_child(req, child_req); 517 nvme_free_request(child_req); 518 } 519 } 520 521 return rc; 522 } 523 524 /* queue those requests which matches with opcode in err_cmd list */ 525 if (spdk_unlikely(!TAILQ_EMPTY(&qpair->err_cmd_head))) { 526 TAILQ_FOREACH(cmd, &qpair->err_cmd_head, link) { 527 if (!cmd->do_not_submit) { 528 continue; 529 } 530 531 if ((cmd->opc == req->cmd.opc) && cmd->err_count) { 532 /* add to error request list and set cpl */ 533 req->timeout_tsc = cmd->timeout_tsc; 534 req->submit_tick = spdk_get_ticks(); 535 req->cpl.status.sct = cmd->status.sct; 536 req->cpl.status.sc = cmd->status.sc; 537 STAILQ_INSERT_TAIL(&qpair->err_req_head, req, stailq); 538 cmd->err_count--; 539 return 0; 540 } 541 } 542 } 543 544 /* assign submit_tick before submitting req to specific transport */ 545 if (spdk_unlikely(ctrlr->timeout_enabled)) { 546 if (req->submit_tick == 0) { /* req submitted for the first time */ 547 req->submit_tick = spdk_get_ticks(); 548 req->timed_out = false; 549 } 550 } else { 551 req->submit_tick = 0; 552 } 553 554 return nvme_transport_qpair_submit_request(qpair, req); 555 } 556 557 static void 558 _nvme_io_qpair_enable(struct spdk_nvme_qpair *qpair) 559 { 560 struct nvme_request *req; 561 562 /* Manually abort each queued I/O. */ 563 while (!STAILQ_EMPTY(&qpair->queued_req)) { 564 req = STAILQ_FIRST(&qpair->queued_req); 565 STAILQ_REMOVE_HEAD(&qpair->queued_req, stailq); 566 SPDK_ERRLOG("aborting queued i/o\n"); 567 nvme_qpair_manual_complete_request(qpair, req, SPDK_NVME_SCT_GENERIC, 568 SPDK_NVME_SC_ABORTED_BY_REQUEST, true); 569 } 570 } 571 572 void 573 nvme_qpair_enable(struct spdk_nvme_qpair *qpair) 574 { 575 if (nvme_qpair_is_io_queue(qpair)) { 576 _nvme_io_qpair_enable(qpair); 577 } 578 579 nvme_transport_qpair_enable(qpair); 580 } 581 582 void 583 nvme_qpair_disable(struct spdk_nvme_qpair *qpair) 584 { 585 struct nvme_request *req; 586 587 while (!STAILQ_EMPTY(&qpair->err_req_head)) { 588 req = STAILQ_FIRST(&qpair->err_req_head); 589 STAILQ_REMOVE_HEAD(&qpair->err_req_head, stailq); 590 nvme_qpair_manual_complete_request(qpair, req, 591 req->cpl.status.sct, 592 req->cpl.status.sc, true); 593 } 594 595 nvme_transport_qpair_disable(qpair); 596 } 597 598 static void 599 nvme_qpair_fail(struct spdk_nvme_qpair *qpair) 600 { 601 struct nvme_request *req; 602 603 while (!STAILQ_EMPTY(&qpair->queued_req)) { 604 req = STAILQ_FIRST(&qpair->queued_req); 605 STAILQ_REMOVE_HEAD(&qpair->queued_req, stailq); 606 SPDK_ERRLOG("failing queued i/o\n"); 607 nvme_qpair_manual_complete_request(qpair, req, SPDK_NVME_SCT_GENERIC, 608 SPDK_NVME_SC_ABORTED_BY_REQUEST, true); 609 } 610 611 nvme_transport_qpair_fail(qpair); 612 } 613 614 int 615 spdk_nvme_qpair_add_cmd_error_injection(struct spdk_nvme_ctrlr *ctrlr, 616 struct spdk_nvme_qpair *qpair, 617 uint8_t opc, bool do_not_submit, 618 uint64_t timeout_in_us, 619 uint32_t err_count, 620 uint8_t sct, uint8_t sc) 621 { 622 struct nvme_error_cmd *entry, *cmd = NULL; 623 624 if (qpair == NULL) { 625 qpair = ctrlr->adminq; 626 } 627 628 TAILQ_FOREACH(entry, &qpair->err_cmd_head, link) { 629 if (entry->opc == opc) { 630 cmd = entry; 631 break; 632 } 633 } 634 635 if (cmd == NULL) { 636 cmd = spdk_dma_zmalloc(sizeof(*cmd), 64, NULL); 637 if (!cmd) { 638 return -ENOMEM; 639 } 640 TAILQ_INSERT_TAIL(&qpair->err_cmd_head, cmd, link); 641 } 642 643 cmd->do_not_submit = do_not_submit; 644 cmd->err_count = err_count; 645 cmd->timeout_tsc = timeout_in_us * spdk_get_ticks_hz() / 1000000ULL; 646 cmd->opc = opc; 647 cmd->status.sct = sct; 648 cmd->status.sc = sc; 649 650 return 0; 651 } 652 653 void 654 spdk_nvme_qpair_remove_cmd_error_injection(struct spdk_nvme_ctrlr *ctrlr, 655 struct spdk_nvme_qpair *qpair, 656 uint8_t opc) 657 { 658 struct nvme_error_cmd *cmd, *entry; 659 660 if (qpair == NULL) { 661 qpair = ctrlr->adminq; 662 } 663 664 TAILQ_FOREACH_SAFE(cmd, &qpair->err_cmd_head, link, entry) { 665 if (cmd->opc == opc) { 666 TAILQ_REMOVE(&qpair->err_cmd_head, cmd, link); 667 spdk_dma_free(cmd); 668 return; 669 } 670 } 671 672 return; 673 } 674