1 /*- 2 * BSD LICENSE 3 * 4 * Copyright (c) Intel Corporation. All rights reserved. 5 * Copyright (c) 2019 Mellanox Technologies LTD. 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 "spdk/stdinc.h" 35 36 #include "bdev_nvme.h" 37 #include "common.h" 38 39 #include "spdk/config.h" 40 41 #include "spdk/string.h" 42 #include "spdk/rpc.h" 43 #include "spdk/util.h" 44 45 #include "spdk_internal/log.h" 46 #include "spdk/bdev_module.h" 47 48 struct open_descriptors { 49 void *desc; 50 struct spdk_bdev *bdev; 51 TAILQ_ENTRY(open_descriptors) tqlst; 52 struct spdk_thread *thread; 53 }; 54 typedef TAILQ_HEAD(, open_descriptors) open_descriptors_t; 55 56 static int 57 rpc_decode_action_on_timeout(const struct spdk_json_val *val, void *out) 58 { 59 enum spdk_bdev_timeout_action *action = out; 60 61 if (spdk_json_strequal(val, "none") == true) { 62 *action = SPDK_BDEV_NVME_TIMEOUT_ACTION_NONE; 63 } else if (spdk_json_strequal(val, "abort") == true) { 64 *action = SPDK_BDEV_NVME_TIMEOUT_ACTION_ABORT; 65 } else if (spdk_json_strequal(val, "reset") == true) { 66 *action = SPDK_BDEV_NVME_TIMEOUT_ACTION_RESET; 67 } else { 68 SPDK_NOTICELOG("Invalid parameter value: action_on_timeout\n"); 69 return -EINVAL; 70 } 71 72 return 0; 73 } 74 75 static const struct spdk_json_object_decoder rpc_bdev_nvme_options_decoders[] = { 76 {"action_on_timeout", offsetof(struct spdk_bdev_nvme_opts, action_on_timeout), rpc_decode_action_on_timeout, true}, 77 {"timeout_us", offsetof(struct spdk_bdev_nvme_opts, timeout_us), spdk_json_decode_uint64, true}, 78 {"retry_count", offsetof(struct spdk_bdev_nvme_opts, retry_count), spdk_json_decode_uint32, true}, 79 {"arbitration_burst", offsetof(struct spdk_bdev_nvme_opts, arbitration_burst), spdk_json_decode_uint32, true}, 80 {"low_priority_weight", offsetof(struct spdk_bdev_nvme_opts, low_priority_weight), spdk_json_decode_uint32, true}, 81 {"medium_priority_weight", offsetof(struct spdk_bdev_nvme_opts, medium_priority_weight), spdk_json_decode_uint32, true}, 82 {"high_priority_weight", offsetof(struct spdk_bdev_nvme_opts, high_priority_weight), spdk_json_decode_uint32, true}, 83 {"nvme_adminq_poll_period_us", offsetof(struct spdk_bdev_nvme_opts, nvme_adminq_poll_period_us), spdk_json_decode_uint64, true}, 84 {"nvme_ioq_poll_period_us", offsetof(struct spdk_bdev_nvme_opts, nvme_ioq_poll_period_us), spdk_json_decode_uint64, true}, 85 {"io_queue_requests", offsetof(struct spdk_bdev_nvme_opts, io_queue_requests), spdk_json_decode_uint32, true}, 86 {"delay_cmd_submit", offsetof(struct spdk_bdev_nvme_opts, delay_cmd_submit), spdk_json_decode_bool, true}, 87 }; 88 89 static void 90 spdk_rpc_bdev_nvme_set_options(struct spdk_jsonrpc_request *request, 91 const struct spdk_json_val *params) 92 { 93 struct spdk_bdev_nvme_opts opts; 94 struct spdk_json_write_ctx *w; 95 int rc; 96 97 spdk_bdev_nvme_get_opts(&opts); 98 if (params && spdk_json_decode_object(params, rpc_bdev_nvme_options_decoders, 99 SPDK_COUNTOF(rpc_bdev_nvme_options_decoders), 100 &opts)) { 101 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 102 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 103 "spdk_json_decode_object failed"); 104 return; 105 } 106 107 rc = spdk_bdev_nvme_set_opts(&opts); 108 if (rc) { 109 spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc)); 110 return; 111 } 112 113 w = spdk_jsonrpc_begin_result(request); 114 spdk_json_write_bool(w, true); 115 spdk_jsonrpc_end_result(request, w); 116 117 return; 118 } 119 SPDK_RPC_REGISTER("bdev_nvme_set_options", spdk_rpc_bdev_nvme_set_options, 120 SPDK_RPC_STARTUP | SPDK_RPC_RUNTIME) 121 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_set_options, set_bdev_nvme_options) 122 123 struct rpc_bdev_nvme_hotplug { 124 bool enabled; 125 uint64_t period_us; 126 }; 127 128 static const struct spdk_json_object_decoder rpc_bdev_nvme_hotplug_decoders[] = { 129 {"enable", offsetof(struct rpc_bdev_nvme_hotplug, enabled), spdk_json_decode_bool, false}, 130 {"period_us", offsetof(struct rpc_bdev_nvme_hotplug, period_us), spdk_json_decode_uint64, true}, 131 }; 132 133 static void 134 rpc_bdev_nvme_set_hotplug_done(void *ctx) 135 { 136 struct spdk_jsonrpc_request *request = ctx; 137 struct spdk_json_write_ctx *w = spdk_jsonrpc_begin_result(request); 138 139 spdk_json_write_bool(w, true); 140 spdk_jsonrpc_end_result(request, w); 141 } 142 143 static void 144 spdk_rpc_bdev_nvme_set_hotplug(struct spdk_jsonrpc_request *request, 145 const struct spdk_json_val *params) 146 { 147 struct rpc_bdev_nvme_hotplug req = {false, 0}; 148 int rc; 149 150 if (spdk_json_decode_object(params, rpc_bdev_nvme_hotplug_decoders, 151 SPDK_COUNTOF(rpc_bdev_nvme_hotplug_decoders), &req)) { 152 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 153 rc = -EINVAL; 154 goto invalid; 155 } 156 157 rc = spdk_bdev_nvme_set_hotplug(req.enabled, req.period_us, rpc_bdev_nvme_set_hotplug_done, 158 request); 159 if (rc) { 160 goto invalid; 161 } 162 163 return; 164 invalid: 165 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, spdk_strerror(-rc)); 166 } 167 SPDK_RPC_REGISTER("bdev_nvme_set_hotplug", spdk_rpc_bdev_nvme_set_hotplug, SPDK_RPC_RUNTIME) 168 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_set_hotplug, set_bdev_nvme_hotplug) 169 170 struct rpc_bdev_nvme_attach_controller { 171 char *name; 172 char *trtype; 173 char *adrfam; 174 char *traddr; 175 char *trsvcid; 176 char *priority; 177 char *subnqn; 178 char *hostnqn; 179 char *hostaddr; 180 char *hostsvcid; 181 bool prchk_reftag; 182 bool prchk_guard; 183 }; 184 185 static void 186 free_rpc_bdev_nvme_attach_controller(struct rpc_bdev_nvme_attach_controller *req) 187 { 188 free(req->name); 189 free(req->trtype); 190 free(req->adrfam); 191 free(req->traddr); 192 free(req->trsvcid); 193 free(req->priority); 194 free(req->subnqn); 195 free(req->hostnqn); 196 free(req->hostaddr); 197 free(req->hostsvcid); 198 } 199 200 static const struct spdk_json_object_decoder rpc_bdev_nvme_attach_controller_decoders[] = { 201 {"name", offsetof(struct rpc_bdev_nvme_attach_controller, name), spdk_json_decode_string}, 202 {"trtype", offsetof(struct rpc_bdev_nvme_attach_controller, trtype), spdk_json_decode_string}, 203 {"traddr", offsetof(struct rpc_bdev_nvme_attach_controller, traddr), spdk_json_decode_string}, 204 205 {"adrfam", offsetof(struct rpc_bdev_nvme_attach_controller, adrfam), spdk_json_decode_string, true}, 206 {"trsvcid", offsetof(struct rpc_bdev_nvme_attach_controller, trsvcid), spdk_json_decode_string, true}, 207 {"priority", offsetof(struct rpc_bdev_nvme_attach_controller, priority), spdk_json_decode_string, true}, 208 {"subnqn", offsetof(struct rpc_bdev_nvme_attach_controller, subnqn), spdk_json_decode_string, true}, 209 {"hostnqn", offsetof(struct rpc_bdev_nvme_attach_controller, hostnqn), spdk_json_decode_string, true}, 210 {"hostaddr", offsetof(struct rpc_bdev_nvme_attach_controller, hostaddr), spdk_json_decode_string, true}, 211 {"hostsvcid", offsetof(struct rpc_bdev_nvme_attach_controller, hostsvcid), spdk_json_decode_string, true}, 212 213 {"prchk_reftag", offsetof(struct rpc_bdev_nvme_attach_controller, prchk_reftag), spdk_json_decode_bool, true}, 214 {"prchk_guard", offsetof(struct rpc_bdev_nvme_attach_controller, prchk_guard), spdk_json_decode_bool, true} 215 }; 216 217 #define NVME_MAX_BDEVS_PER_RPC 128 218 219 struct rpc_bdev_nvme_attach_controller_ctx { 220 struct rpc_bdev_nvme_attach_controller req; 221 uint32_t count; 222 const char *names[NVME_MAX_BDEVS_PER_RPC]; 223 struct spdk_jsonrpc_request *request; 224 }; 225 226 static void 227 spdk_rpc_bdev_nvme_attach_controller_done(void *cb_ctx, size_t bdev_count, int rc) 228 { 229 struct rpc_bdev_nvme_attach_controller_ctx *ctx = cb_ctx; 230 struct spdk_jsonrpc_request *request = ctx->request; 231 struct spdk_json_write_ctx *w; 232 size_t i; 233 234 if (rc < 0) { 235 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 236 goto exit; 237 } 238 239 w = spdk_jsonrpc_begin_result(request); 240 spdk_json_write_array_begin(w); 241 for (i = 0; i < bdev_count; i++) { 242 spdk_json_write_string(w, ctx->names[i]); 243 } 244 spdk_json_write_array_end(w); 245 spdk_jsonrpc_end_result(request, w); 246 247 exit: 248 free_rpc_bdev_nvme_attach_controller(&ctx->req); 249 free(ctx); 250 } 251 252 static void 253 spdk_rpc_bdev_nvme_attach_controller(struct spdk_jsonrpc_request *request, 254 const struct spdk_json_val *params) 255 { 256 struct rpc_bdev_nvme_attach_controller_ctx *ctx; 257 struct spdk_nvme_transport_id trid = {}; 258 struct spdk_nvme_host_id hostid = {}; 259 uint32_t prchk_flags = 0; 260 int rc; 261 262 ctx = calloc(1, sizeof(*ctx)); 263 if (!ctx) { 264 spdk_jsonrpc_send_error_response(request, -ENOMEM, spdk_strerror(ENOMEM)); 265 return; 266 } 267 268 if (spdk_json_decode_object(params, rpc_bdev_nvme_attach_controller_decoders, 269 SPDK_COUNTOF(rpc_bdev_nvme_attach_controller_decoders), 270 &ctx->req)) { 271 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 272 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 273 "spdk_json_decode_object failed"); 274 goto cleanup; 275 } 276 277 /* Parse trstring */ 278 rc = spdk_nvme_transport_id_populate_trstring(&trid, ctx->req.trtype); 279 if (rc < 0) { 280 SPDK_ERRLOG("Failed to parse trtype: %s\n", ctx->req.trtype); 281 spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse trtype: %s", 282 ctx->req.trtype); 283 goto cleanup; 284 } 285 286 /* Parse trtype */ 287 rc = spdk_nvme_transport_id_parse_trtype(&trid.trtype, ctx->req.trtype); 288 assert(rc == 0); 289 290 /* Parse traddr */ 291 snprintf(trid.traddr, sizeof(trid.traddr), "%s", ctx->req.traddr); 292 293 /* Parse adrfam */ 294 if (ctx->req.adrfam) { 295 rc = spdk_nvme_transport_id_parse_adrfam(&trid.adrfam, ctx->req.adrfam); 296 if (rc < 0) { 297 SPDK_ERRLOG("Failed to parse adrfam: %s\n", ctx->req.adrfam); 298 spdk_jsonrpc_send_error_response_fmt(request, -EINVAL, "Failed to parse adrfam: %s", 299 ctx->req.adrfam); 300 goto cleanup; 301 } 302 } 303 304 /* Parse trsvcid */ 305 if (ctx->req.trsvcid) { 306 snprintf(trid.trsvcid, sizeof(trid.trsvcid), "%s", ctx->req.trsvcid); 307 } 308 309 /* Parse priority for the NVMe-oF transport connection */ 310 if (ctx->req.priority) { 311 trid.priority = spdk_strtol(ctx->req.priority, 10); 312 } 313 314 /* Parse subnqn */ 315 if (ctx->req.subnqn) { 316 snprintf(trid.subnqn, sizeof(trid.subnqn), "%s", ctx->req.subnqn); 317 } 318 319 if (ctx->req.hostaddr) { 320 snprintf(hostid.hostaddr, sizeof(hostid.hostaddr), "%s", ctx->req.hostaddr); 321 } 322 323 if (ctx->req.hostsvcid) { 324 snprintf(hostid.hostsvcid, sizeof(hostid.hostsvcid), "%s", ctx->req.hostsvcid); 325 } 326 327 if (ctx->req.prchk_reftag) { 328 prchk_flags |= SPDK_NVME_IO_FLAGS_PRCHK_REFTAG; 329 } 330 331 if (ctx->req.prchk_guard) { 332 prchk_flags |= SPDK_NVME_IO_FLAGS_PRCHK_GUARD; 333 } 334 335 ctx->request = request; 336 ctx->count = NVME_MAX_BDEVS_PER_RPC; 337 rc = spdk_bdev_nvme_create(&trid, &hostid, ctx->req.name, ctx->names, ctx->count, ctx->req.hostnqn, 338 prchk_flags, spdk_rpc_bdev_nvme_attach_controller_done, ctx); 339 if (rc) { 340 spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc)); 341 goto cleanup; 342 } 343 344 return; 345 346 cleanup: 347 free_rpc_bdev_nvme_attach_controller(&ctx->req); 348 free(ctx); 349 } 350 SPDK_RPC_REGISTER("bdev_nvme_attach_controller", spdk_rpc_bdev_nvme_attach_controller, 351 SPDK_RPC_RUNTIME) 352 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_attach_controller, construct_nvme_bdev) 353 354 static void 355 spdk_rpc_dump_nvme_controller_info(struct spdk_json_write_ctx *w, 356 struct nvme_bdev_ctrlr *nvme_bdev_ctrlr) 357 { 358 struct spdk_nvme_transport_id *trid; 359 360 trid = &nvme_bdev_ctrlr->trid; 361 362 spdk_json_write_object_begin(w); 363 spdk_json_write_named_string(w, "name", nvme_bdev_ctrlr->name); 364 365 #ifdef SPDK_CONFIG_NVME_CUSE 366 size_t cuse_name_size = 128; 367 char cuse_name[cuse_name_size]; 368 369 int rc = spdk_nvme_cuse_get_ctrlr_name(nvme_bdev_ctrlr->ctrlr, cuse_name, &cuse_name_size); 370 if (rc == 0) { 371 spdk_json_write_named_string(w, "cuse_device", cuse_name); 372 } 373 #endif 374 375 spdk_json_write_named_object_begin(w, "trid"); 376 nvme_bdev_dump_trid_json(trid, w); 377 spdk_json_write_object_end(w); 378 379 spdk_json_write_object_end(w); 380 } 381 382 struct rpc_bdev_nvme_get_controllers { 383 char *name; 384 }; 385 386 static void 387 free_rpc_bdev_nvme_get_controllers(struct rpc_bdev_nvme_get_controllers *r) 388 { 389 free(r->name); 390 } 391 392 static const struct spdk_json_object_decoder rpc_bdev_nvme_get_controllers_decoders[] = { 393 {"name", offsetof(struct rpc_bdev_nvme_get_controllers, name), spdk_json_decode_string, true}, 394 }; 395 396 static void 397 spdk_rpc_bdev_nvme_get_controllers(struct spdk_jsonrpc_request *request, 398 const struct spdk_json_val *params) 399 { 400 struct rpc_bdev_nvme_get_controllers req = {}; 401 struct spdk_json_write_ctx *w; 402 struct nvme_bdev_ctrlr *ctrlr = NULL; 403 404 if (params && spdk_json_decode_object(params, rpc_bdev_nvme_get_controllers_decoders, 405 SPDK_COUNTOF(rpc_bdev_nvme_get_controllers_decoders), 406 &req)) { 407 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 408 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 409 "spdk_json_decode_object failed"); 410 goto cleanup; 411 } 412 413 if (req.name) { 414 ctrlr = nvme_bdev_ctrlr_get_by_name(req.name); 415 if (ctrlr == NULL) { 416 SPDK_ERRLOG("ctrlr '%s' does not exist\n", req.name); 417 spdk_jsonrpc_send_error_response_fmt(request, EINVAL, "Controller %s does not exist", req.name); 418 goto cleanup; 419 } 420 } 421 422 w = spdk_jsonrpc_begin_result(request); 423 spdk_json_write_array_begin(w); 424 425 if (ctrlr != NULL) { 426 spdk_rpc_dump_nvme_controller_info(w, ctrlr); 427 } else { 428 for (ctrlr = nvme_bdev_first_ctrlr(); ctrlr; ctrlr = nvme_bdev_next_ctrlr(ctrlr)) { 429 spdk_rpc_dump_nvme_controller_info(w, ctrlr); 430 } 431 } 432 433 spdk_json_write_array_end(w); 434 435 spdk_jsonrpc_end_result(request, w); 436 437 cleanup: 438 free_rpc_bdev_nvme_get_controllers(&req); 439 } 440 SPDK_RPC_REGISTER("bdev_nvme_get_controllers", spdk_rpc_bdev_nvme_get_controllers, SPDK_RPC_RUNTIME) 441 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_get_controllers, get_nvme_controllers) 442 443 struct rpc_bdev_nvme_detach_controller { 444 char *name; 445 }; 446 447 static void 448 free_rpc_bdev_nvme_detach_controller(struct rpc_bdev_nvme_detach_controller *req) 449 { 450 free(req->name); 451 } 452 453 static const struct spdk_json_object_decoder rpc_bdev_nvme_detach_controller_decoders[] = { 454 {"name", offsetof(struct rpc_bdev_nvme_detach_controller, name), spdk_json_decode_string}, 455 }; 456 457 static void 458 spdk_rpc_bdev_nvme_detach_controller(struct spdk_jsonrpc_request *request, 459 const struct spdk_json_val *params) 460 { 461 struct rpc_bdev_nvme_detach_controller req = {NULL}; 462 struct spdk_json_write_ctx *w; 463 int rc = 0; 464 465 if (spdk_json_decode_object(params, rpc_bdev_nvme_detach_controller_decoders, 466 SPDK_COUNTOF(rpc_bdev_nvme_detach_controller_decoders), 467 &req)) { 468 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 469 "spdk_json_decode_object failed"); 470 goto cleanup; 471 } 472 473 rc = spdk_bdev_nvme_delete(req.name); 474 if (rc != 0) { 475 spdk_jsonrpc_send_error_response(request, rc, spdk_strerror(-rc)); 476 goto cleanup; 477 } 478 479 w = spdk_jsonrpc_begin_result(request); 480 spdk_json_write_bool(w, true); 481 spdk_jsonrpc_end_result(request, w); 482 483 cleanup: 484 free_rpc_bdev_nvme_detach_controller(&req); 485 } 486 SPDK_RPC_REGISTER("bdev_nvme_detach_controller", spdk_rpc_bdev_nvme_detach_controller, 487 SPDK_RPC_RUNTIME) 488 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_detach_controller, delete_nvme_controller) 489 490 struct rpc_apply_firmware { 491 char *filename; 492 char *bdev_name; 493 }; 494 495 static void 496 free_rpc_apply_firmware(struct rpc_apply_firmware *req) 497 { 498 free(req->filename); 499 free(req->bdev_name); 500 } 501 502 static const struct spdk_json_object_decoder rpc_apply_firmware_decoders[] = { 503 {"filename", offsetof(struct rpc_apply_firmware, filename), spdk_json_decode_string}, 504 {"bdev_name", offsetof(struct rpc_apply_firmware, bdev_name), spdk_json_decode_string}, 505 }; 506 507 struct firmware_update_info { 508 void *fw_image; 509 void *p; 510 unsigned int size; 511 unsigned int size_remaining; 512 unsigned int offset; 513 unsigned int transfer; 514 515 void *desc; 516 struct spdk_io_channel *ch; 517 struct spdk_jsonrpc_request *request; 518 struct spdk_nvme_ctrlr *ctrlr; 519 open_descriptors_t desc_head; 520 struct rpc_apply_firmware *req; 521 }; 522 523 static void 524 _apply_firmware_cleanup(void *ctx) 525 { 526 struct spdk_bdev_desc *desc = ctx; 527 528 spdk_bdev_close(desc); 529 } 530 531 static void 532 apply_firmware_cleanup(void *cb_arg) 533 { 534 struct open_descriptors *opt, *tmp; 535 struct firmware_update_info *firm_ctx = cb_arg; 536 537 if (!firm_ctx) { 538 return; 539 } 540 541 if (firm_ctx->fw_image) { 542 spdk_free(firm_ctx->fw_image); 543 } 544 545 if (firm_ctx->req) { 546 free_rpc_apply_firmware(firm_ctx->req); 547 free(firm_ctx->req); 548 } 549 550 if (firm_ctx->ch) { 551 spdk_put_io_channel(firm_ctx->ch); 552 } 553 554 TAILQ_FOREACH_SAFE(opt, &firm_ctx->desc_head, tqlst, tmp) { 555 TAILQ_REMOVE(&firm_ctx->desc_head, opt, tqlst); 556 /* Close the underlying bdev on its same opened thread. */ 557 if (opt->thread && opt->thread != spdk_get_thread()) { 558 spdk_thread_send_msg(opt->thread, _apply_firmware_cleanup, opt->desc); 559 } else { 560 spdk_bdev_close(opt->desc); 561 } 562 free(opt); 563 } 564 free(firm_ctx); 565 } 566 567 static void 568 apply_firmware_complete_reset(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg) 569 { 570 int rc; 571 struct spdk_json_write_ctx *w; 572 struct firmware_update_info *firm_ctx = cb_arg; 573 574 spdk_bdev_free_io(bdev_io); 575 576 if (!success) { 577 spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 578 "firmware commit failed."); 579 apply_firmware_cleanup(firm_ctx); 580 return; 581 } 582 583 if ((rc = spdk_nvme_ctrlr_reset(firm_ctx->ctrlr)) != 0) { 584 spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 585 "Controller reset failed."); 586 apply_firmware_cleanup(firm_ctx); 587 return; 588 } 589 590 w = spdk_jsonrpc_begin_result(firm_ctx->request); 591 spdk_json_write_string(w, "firmware commit succeeded. Controller reset in progress."); 592 spdk_jsonrpc_end_result(firm_ctx->request, w); 593 apply_firmware_cleanup(firm_ctx); 594 } 595 596 static void 597 apply_firmware_complete(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg) 598 { 599 struct spdk_nvme_cmd cmd = {}; 600 struct spdk_nvme_fw_commit fw_commit; 601 int slot = 0; 602 int rc; 603 struct firmware_update_info *firm_ctx = cb_arg; 604 enum spdk_nvme_fw_commit_action commit_action = SPDK_NVME_FW_COMMIT_REPLACE_AND_ENABLE_IMG; 605 606 if (!success) { 607 spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 608 "firmware download failed ."); 609 spdk_bdev_free_io(bdev_io); 610 apply_firmware_cleanup(firm_ctx); 611 return; 612 } 613 614 firm_ctx->p += firm_ctx->transfer; 615 firm_ctx->offset += firm_ctx->transfer; 616 firm_ctx->size_remaining -= firm_ctx->transfer; 617 618 switch (firm_ctx->size_remaining) { 619 case 0: 620 /* firmware download completed. Commit firmware */ 621 memset(&fw_commit, 0, sizeof(struct spdk_nvme_fw_commit)); 622 fw_commit.fs = slot; 623 fw_commit.ca = commit_action; 624 625 cmd.opc = SPDK_NVME_OPC_FIRMWARE_COMMIT; 626 memcpy(&cmd.cdw10, &fw_commit, sizeof(uint32_t)); 627 rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, &cmd, NULL, 0, 628 apply_firmware_complete_reset, firm_ctx); 629 if (rc) { 630 spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 631 "firmware commit failed."); 632 spdk_bdev_free_io(bdev_io); 633 apply_firmware_cleanup(firm_ctx); 634 return; 635 } 636 break; 637 default: 638 firm_ctx->transfer = spdk_min(firm_ctx->size_remaining, 4096); 639 cmd.opc = SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD; 640 641 cmd.cdw10 = (firm_ctx->transfer >> 2) - 1; 642 cmd.cdw11 = firm_ctx->offset >> 2; 643 rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, &cmd, firm_ctx->p, 644 firm_ctx->transfer, apply_firmware_complete, firm_ctx); 645 if (rc) { 646 spdk_jsonrpc_send_error_response(firm_ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 647 "firmware download failed."); 648 spdk_bdev_free_io(bdev_io); 649 apply_firmware_cleanup(firm_ctx); 650 return; 651 } 652 break; 653 } 654 } 655 656 static void 657 spdk_rpc_bdev_nvme_apply_firmware(struct spdk_jsonrpc_request *request, 658 const struct spdk_json_val *params) 659 { 660 int rc; 661 int fd = -1; 662 struct stat fw_stat; 663 struct spdk_nvme_ctrlr *ctrlr; 664 char msg[1024]; 665 struct spdk_bdev *bdev; 666 struct spdk_bdev *bdev2; 667 struct open_descriptors *opt; 668 struct spdk_bdev_desc *desc; 669 struct spdk_nvme_cmd *cmd; 670 struct firmware_update_info *firm_ctx; 671 672 firm_ctx = calloc(1, sizeof(struct firmware_update_info)); 673 if (!firm_ctx) { 674 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 675 "Memory allocation error."); 676 return; 677 } 678 firm_ctx->fw_image = NULL; 679 TAILQ_INIT(&firm_ctx->desc_head); 680 firm_ctx->request = request; 681 682 firm_ctx->req = calloc(1, sizeof(struct rpc_apply_firmware)); 683 if (!firm_ctx->req) { 684 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 685 "Memory allocation error."); 686 free(firm_ctx); 687 return; 688 } 689 690 if (spdk_json_decode_object(params, rpc_apply_firmware_decoders, 691 SPDK_COUNTOF(rpc_apply_firmware_decoders), firm_ctx->req)) { 692 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 693 "spdk_json_decode_object failed."); 694 free(firm_ctx->req); 695 free(firm_ctx); 696 return; 697 } 698 699 if ((bdev = spdk_bdev_get_by_name(firm_ctx->req->bdev_name)) == NULL) { 700 snprintf(msg, sizeof(msg), "bdev %s were not found", firm_ctx->req->bdev_name); 701 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg); 702 apply_firmware_cleanup(firm_ctx); 703 return; 704 } 705 706 if ((ctrlr = spdk_bdev_nvme_get_ctrlr(bdev)) == NULL) { 707 snprintf(msg, sizeof(msg), "Controller information for %s were not found.", 708 firm_ctx->req->bdev_name); 709 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg); 710 apply_firmware_cleanup(firm_ctx); 711 return; 712 } 713 firm_ctx->ctrlr = ctrlr; 714 715 for (bdev2 = spdk_bdev_first(); bdev2; bdev2 = spdk_bdev_next(bdev2)) { 716 717 if (spdk_bdev_nvme_get_ctrlr(bdev2) != ctrlr) { 718 continue; 719 } 720 721 if (!(opt = malloc(sizeof(struct open_descriptors)))) { 722 snprintf(msg, sizeof(msg), "Memory allocation error."); 723 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg); 724 apply_firmware_cleanup(firm_ctx); 725 return; 726 } 727 728 if ((rc = spdk_bdev_open(bdev2, true, NULL, NULL, &desc)) != 0) { 729 snprintf(msg, sizeof(msg), "Device %s is in use.", firm_ctx->req->bdev_name); 730 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, msg); 731 free(opt); 732 apply_firmware_cleanup(firm_ctx); 733 return; 734 } 735 736 /* Save the thread where the base device is opened */ 737 opt->thread = spdk_get_thread(); 738 739 opt->desc = desc; 740 opt->bdev = bdev; 741 TAILQ_INSERT_TAIL(&firm_ctx->desc_head, opt, tqlst); 742 } 743 744 /* 745 * find a descriptor associated with our bdev 746 */ 747 firm_ctx->desc = NULL; 748 TAILQ_FOREACH(opt, &firm_ctx->desc_head, tqlst) { 749 if (opt->bdev == bdev) { 750 firm_ctx->desc = opt->desc; 751 break; 752 } 753 } 754 755 if (!firm_ctx->desc) { 756 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 757 "No descriptor were found."); 758 apply_firmware_cleanup(firm_ctx); 759 return; 760 } 761 762 firm_ctx->ch = spdk_bdev_get_io_channel(firm_ctx->desc); 763 if (!firm_ctx->ch) { 764 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 765 "No channels were found."); 766 apply_firmware_cleanup(firm_ctx); 767 return; 768 } 769 770 fd = open(firm_ctx->req->filename, O_RDONLY); 771 if (fd < 0) { 772 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "open file failed."); 773 apply_firmware_cleanup(firm_ctx); 774 return; 775 } 776 777 rc = fstat(fd, &fw_stat); 778 if (rc < 0) { 779 close(fd); 780 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "fstat failed."); 781 apply_firmware_cleanup(firm_ctx); 782 return; 783 } 784 785 firm_ctx->size = fw_stat.st_size; 786 if (fw_stat.st_size % 4) { 787 close(fd); 788 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 789 "Firmware image size is not multiple of 4."); 790 apply_firmware_cleanup(firm_ctx); 791 return; 792 } 793 794 firm_ctx->fw_image = spdk_zmalloc(firm_ctx->size, 4096, NULL, 795 SPDK_ENV_LCORE_ID_ANY, SPDK_MALLOC_DMA); 796 if (!firm_ctx->fw_image) { 797 close(fd); 798 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 799 "Memory allocation error."); 800 apply_firmware_cleanup(firm_ctx); 801 return; 802 } 803 firm_ctx->p = firm_ctx->fw_image; 804 805 if (read(fd, firm_ctx->p, firm_ctx->size) != ((ssize_t)(firm_ctx->size))) { 806 close(fd); 807 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 808 "Read firmware image failed!"); 809 apply_firmware_cleanup(firm_ctx); 810 return; 811 } 812 close(fd); 813 814 firm_ctx->offset = 0; 815 firm_ctx->size_remaining = firm_ctx->size; 816 firm_ctx->transfer = spdk_min(firm_ctx->size_remaining, 4096); 817 818 cmd = malloc(sizeof(struct spdk_nvme_cmd)); 819 if (!cmd) { 820 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 821 "Memory allocation error."); 822 apply_firmware_cleanup(firm_ctx); 823 return; 824 } 825 memset(cmd, 0, sizeof(struct spdk_nvme_cmd)); 826 cmd->opc = SPDK_NVME_OPC_FIRMWARE_IMAGE_DOWNLOAD; 827 828 cmd->cdw10 = (firm_ctx->transfer >> 2) - 1; 829 cmd->cdw11 = firm_ctx->offset >> 2; 830 831 rc = spdk_bdev_nvme_admin_passthru(firm_ctx->desc, firm_ctx->ch, cmd, firm_ctx->p, 832 firm_ctx->transfer, apply_firmware_complete, firm_ctx); 833 if (rc) { 834 free(cmd); 835 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 836 "Read firmware image failed!"); 837 apply_firmware_cleanup(firm_ctx); 838 return; 839 } 840 } 841 SPDK_RPC_REGISTER("bdev_nvme_apply_firmware", spdk_rpc_bdev_nvme_apply_firmware, SPDK_RPC_RUNTIME) 842 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(bdev_nvme_apply_firmware, apply_nvme_firmware) 843