1 /*- 2 * BSD LICENSE 3 * 4 * Copyright (c) Intel Corporation. All rights reserved. 5 * Copyright (c) 2018-2020 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/bdev.h" 35 #include "spdk/log.h" 36 #include "spdk/rpc.h" 37 #include "spdk/env.h" 38 #include "spdk/nvme.h" 39 #include "spdk/nvmf.h" 40 #include "spdk/string.h" 41 #include "spdk/util.h" 42 #include "spdk/bit_array.h" 43 44 #include "spdk_internal/assert.h" 45 46 #include "nvmf_internal.h" 47 48 static int 49 json_write_hex_str(struct spdk_json_write_ctx *w, const void *data, size_t size) 50 { 51 static const char hex_char[16] = "0123456789ABCDEF"; 52 const uint8_t *buf = data; 53 char *str, *out; 54 int rc; 55 56 str = malloc(size * 2 + 1); 57 if (str == NULL) { 58 return -1; 59 } 60 61 out = str; 62 while (size--) { 63 unsigned byte = *buf++; 64 65 out[0] = hex_char[(byte >> 4) & 0xF]; 66 out[1] = hex_char[byte & 0xF]; 67 68 out += 2; 69 } 70 *out = '\0'; 71 72 rc = spdk_json_write_string(w, str); 73 free(str); 74 75 return rc; 76 } 77 78 static int 79 hex_nybble_to_num(char c) 80 { 81 if (c >= '0' && c <= '9') { 82 return c - '0'; 83 } 84 85 if (c >= 'a' && c <= 'f') { 86 return c - 'a' + 0xA; 87 } 88 89 if (c >= 'A' && c <= 'F') { 90 return c - 'A' + 0xA; 91 } 92 93 return -1; 94 } 95 96 static int 97 hex_byte_to_num(const char *str) 98 { 99 int hi, lo; 100 101 hi = hex_nybble_to_num(str[0]); 102 if (hi < 0) { 103 return hi; 104 } 105 106 lo = hex_nybble_to_num(str[1]); 107 if (lo < 0) { 108 return lo; 109 } 110 111 return hi * 16 + lo; 112 } 113 114 static int 115 decode_hex_string_be(const char *str, uint8_t *out, size_t size) 116 { 117 size_t i; 118 119 /* Decode a string in "ABCDEF012345" format to its binary representation */ 120 for (i = 0; i < size; i++) { 121 int num = hex_byte_to_num(str); 122 123 if (num < 0) { 124 /* Invalid hex byte or end of string */ 125 return -1; 126 } 127 128 out[i] = (uint8_t)num; 129 str += 2; 130 } 131 132 if (i != size || *str != '\0') { 133 /* Length mismatch */ 134 return -1; 135 } 136 137 return 0; 138 } 139 140 static int 141 decode_ns_nguid(const struct spdk_json_val *val, void *out) 142 { 143 char *str = NULL; 144 int rc; 145 146 rc = spdk_json_decode_string(val, &str); 147 if (rc == 0) { 148 /* 16-byte NGUID */ 149 rc = decode_hex_string_be(str, out, 16); 150 } 151 152 free(str); 153 return rc; 154 } 155 156 static int 157 decode_ns_eui64(const struct spdk_json_val *val, void *out) 158 { 159 char *str = NULL; 160 int rc; 161 162 rc = spdk_json_decode_string(val, &str); 163 if (rc == 0) { 164 /* 8-byte EUI-64 */ 165 rc = decode_hex_string_be(str, out, 8); 166 } 167 168 free(str); 169 return rc; 170 } 171 172 static int 173 decode_ns_uuid(const struct spdk_json_val *val, void *out) 174 { 175 char *str = NULL; 176 int rc; 177 178 rc = spdk_json_decode_string(val, &str); 179 if (rc == 0) { 180 rc = spdk_uuid_parse(out, str); 181 } 182 183 free(str); 184 return rc; 185 } 186 187 struct rpc_get_subsystem { 188 char *tgt_name; 189 }; 190 191 static const struct spdk_json_object_decoder rpc_get_subsystem_decoders[] = { 192 {"tgt_name", offsetof(struct rpc_get_subsystem, tgt_name), spdk_json_decode_string, true}, 193 }; 194 195 static void 196 dump_nvmf_subsystem(struct spdk_json_write_ctx *w, struct spdk_nvmf_subsystem *subsystem) 197 { 198 struct spdk_nvmf_host *host; 199 struct spdk_nvmf_subsystem_listener *listener; 200 201 spdk_json_write_object_begin(w); 202 203 spdk_json_write_named_string(w, "nqn", spdk_nvmf_subsystem_get_nqn(subsystem)); 204 spdk_json_write_name(w, "subtype"); 205 if (spdk_nvmf_subsystem_get_type(subsystem) == SPDK_NVMF_SUBTYPE_NVME) { 206 spdk_json_write_string(w, "NVMe"); 207 } else { 208 spdk_json_write_string(w, "Discovery"); 209 } 210 211 spdk_json_write_named_array_begin(w, "listen_addresses"); 212 213 for (listener = spdk_nvmf_subsystem_get_first_listener(subsystem); listener != NULL; 214 listener = spdk_nvmf_subsystem_get_next_listener(subsystem, listener)) { 215 const struct spdk_nvme_transport_id *trid; 216 const char *adrfam; 217 218 trid = spdk_nvmf_subsystem_listener_get_trid(listener); 219 220 spdk_json_write_object_begin(w); 221 adrfam = spdk_nvme_transport_id_adrfam_str(trid->adrfam); 222 if (adrfam == NULL) { 223 adrfam = "unknown"; 224 } 225 /* NOTE: "transport" is kept for compatibility; new code should use "trtype" */ 226 spdk_json_write_named_string(w, "transport", trid->trstring); 227 spdk_json_write_named_string(w, "trtype", trid->trstring); 228 spdk_json_write_named_string(w, "adrfam", adrfam); 229 spdk_json_write_named_string(w, "traddr", trid->traddr); 230 spdk_json_write_named_string(w, "trsvcid", trid->trsvcid); 231 spdk_json_write_object_end(w); 232 } 233 spdk_json_write_array_end(w); 234 235 spdk_json_write_named_bool(w, "allow_any_host", 236 spdk_nvmf_subsystem_get_allow_any_host(subsystem)); 237 238 spdk_json_write_named_array_begin(w, "hosts"); 239 240 for (host = spdk_nvmf_subsystem_get_first_host(subsystem); host != NULL; 241 host = spdk_nvmf_subsystem_get_next_host(subsystem, host)) { 242 spdk_json_write_object_begin(w); 243 spdk_json_write_named_string(w, "nqn", spdk_nvmf_host_get_nqn(host)); 244 spdk_json_write_object_end(w); 245 } 246 spdk_json_write_array_end(w); 247 248 if (spdk_nvmf_subsystem_get_type(subsystem) == SPDK_NVMF_SUBTYPE_NVME) { 249 struct spdk_nvmf_ns *ns; 250 struct spdk_nvmf_ns_opts ns_opts; 251 uint32_t max_namespaces; 252 253 spdk_json_write_named_string(w, "serial_number", spdk_nvmf_subsystem_get_sn(subsystem)); 254 255 spdk_json_write_named_string(w, "model_number", spdk_nvmf_subsystem_get_mn(subsystem)); 256 257 max_namespaces = spdk_nvmf_subsystem_get_max_namespaces(subsystem); 258 if (max_namespaces != 0) { 259 spdk_json_write_named_uint32(w, "max_namespaces", max_namespaces); 260 } 261 262 spdk_json_write_named_array_begin(w, "namespaces"); 263 for (ns = spdk_nvmf_subsystem_get_first_ns(subsystem); ns != NULL; 264 ns = spdk_nvmf_subsystem_get_next_ns(subsystem, ns)) { 265 spdk_nvmf_ns_get_opts(ns, &ns_opts, sizeof(ns_opts)); 266 spdk_json_write_object_begin(w); 267 spdk_json_write_named_int32(w, "nsid", spdk_nvmf_ns_get_id(ns)); 268 spdk_json_write_named_string(w, "bdev_name", 269 spdk_bdev_get_name(spdk_nvmf_ns_get_bdev(ns))); 270 /* NOTE: "name" is kept for compatibility only - new code should use bdev_name. */ 271 spdk_json_write_named_string(w, "name", 272 spdk_bdev_get_name(spdk_nvmf_ns_get_bdev(ns))); 273 274 if (!spdk_mem_all_zero(ns_opts.nguid, sizeof(ns_opts.nguid))) { 275 spdk_json_write_name(w, "nguid"); 276 json_write_hex_str(w, ns_opts.nguid, sizeof(ns_opts.nguid)); 277 } 278 279 if (!spdk_mem_all_zero(ns_opts.eui64, sizeof(ns_opts.eui64))) { 280 spdk_json_write_name(w, "eui64"); 281 json_write_hex_str(w, ns_opts.eui64, sizeof(ns_opts.eui64)); 282 } 283 284 if (!spdk_mem_all_zero(&ns_opts.uuid, sizeof(ns_opts.uuid))) { 285 char uuid_str[SPDK_UUID_STRING_LEN]; 286 287 spdk_uuid_fmt_lower(uuid_str, sizeof(uuid_str), &ns_opts.uuid); 288 spdk_json_write_named_string(w, "uuid", uuid_str); 289 } 290 291 spdk_json_write_object_end(w); 292 } 293 spdk_json_write_array_end(w); 294 } 295 spdk_json_write_object_end(w); 296 } 297 298 static void 299 rpc_nvmf_get_subsystems(struct spdk_jsonrpc_request *request, 300 const struct spdk_json_val *params) 301 { 302 struct rpc_get_subsystem req = { 0 }; 303 struct spdk_json_write_ctx *w; 304 struct spdk_nvmf_subsystem *subsystem; 305 struct spdk_nvmf_tgt *tgt; 306 307 if (params) { 308 if (spdk_json_decode_object(params, rpc_get_subsystem_decoders, 309 SPDK_COUNTOF(rpc_get_subsystem_decoders), 310 &req)) { 311 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 312 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 313 return; 314 } 315 } 316 317 tgt = spdk_nvmf_get_tgt(req.tgt_name); 318 if (!tgt) { 319 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 320 "Unable to find a target."); 321 free(req.tgt_name); 322 return; 323 } 324 325 w = spdk_jsonrpc_begin_result(request); 326 spdk_json_write_array_begin(w); 327 subsystem = spdk_nvmf_subsystem_get_first(tgt); 328 while (subsystem) { 329 dump_nvmf_subsystem(w, subsystem); 330 subsystem = spdk_nvmf_subsystem_get_next(subsystem); 331 } 332 spdk_json_write_array_end(w); 333 spdk_jsonrpc_end_result(request, w); 334 free(req.tgt_name); 335 } 336 SPDK_RPC_REGISTER("nvmf_get_subsystems", rpc_nvmf_get_subsystems, SPDK_RPC_RUNTIME) 337 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(nvmf_get_subsystems, get_nvmf_subsystems) 338 339 struct rpc_subsystem_create { 340 char *nqn; 341 char *serial_number; 342 char *model_number; 343 char *tgt_name; 344 uint32_t max_namespaces; 345 bool allow_any_host; 346 bool ana_reporting; 347 }; 348 349 static const struct spdk_json_object_decoder rpc_subsystem_create_decoders[] = { 350 {"nqn", offsetof(struct rpc_subsystem_create, nqn), spdk_json_decode_string}, 351 {"serial_number", offsetof(struct rpc_subsystem_create, serial_number), spdk_json_decode_string, true}, 352 {"model_number", offsetof(struct rpc_subsystem_create, model_number), spdk_json_decode_string, true}, 353 {"tgt_name", offsetof(struct rpc_subsystem_create, tgt_name), spdk_json_decode_string, true}, 354 {"max_namespaces", offsetof(struct rpc_subsystem_create, max_namespaces), spdk_json_decode_uint32, true}, 355 {"allow_any_host", offsetof(struct rpc_subsystem_create, allow_any_host), spdk_json_decode_bool, true}, 356 {"ana_reporting", offsetof(struct rpc_subsystem_create, ana_reporting), spdk_json_decode_bool, true}, 357 }; 358 359 static void 360 rpc_nvmf_subsystem_started(struct spdk_nvmf_subsystem *subsystem, 361 void *cb_arg, int status) 362 { 363 struct spdk_jsonrpc_request *request = cb_arg; 364 365 if (!status) { 366 struct spdk_json_write_ctx *w = spdk_jsonrpc_begin_result(request); 367 spdk_json_write_bool(w, true); 368 spdk_jsonrpc_end_result(request, w); 369 } else { 370 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 371 "Subsystem %s start failed", 372 subsystem->subnqn); 373 spdk_nvmf_subsystem_destroy(subsystem); 374 } 375 } 376 377 static void 378 rpc_nvmf_create_subsystem(struct spdk_jsonrpc_request *request, 379 const struct spdk_json_val *params) 380 { 381 struct rpc_subsystem_create *req; 382 struct spdk_nvmf_subsystem *subsystem = NULL; 383 struct spdk_nvmf_tgt *tgt; 384 int rc = -1; 385 386 req = calloc(1, sizeof(*req)); 387 if (!req) { 388 SPDK_ERRLOG("Memory allocation failed\n"); 389 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 390 "Memory allocation failed"); 391 return; 392 } 393 394 if (spdk_json_decode_object(params, rpc_subsystem_create_decoders, 395 SPDK_COUNTOF(rpc_subsystem_create_decoders), 396 req)) { 397 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 398 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 399 goto cleanup; 400 } 401 402 tgt = spdk_nvmf_get_tgt(req->tgt_name); 403 if (!tgt) { 404 SPDK_ERRLOG("Unable to find target %s\n", req->tgt_name); 405 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 406 "Unable to find target %s", req->tgt_name); 407 goto cleanup; 408 } 409 410 subsystem = spdk_nvmf_subsystem_create(tgt, req->nqn, SPDK_NVMF_SUBTYPE_NVME, 411 req->max_namespaces); 412 if (!subsystem) { 413 SPDK_ERRLOG("Unable to create subsystem %s\n", req->nqn); 414 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 415 "Unable to create subsystem %s", req->nqn); 416 goto cleanup; 417 } 418 419 if (req->serial_number) { 420 if (spdk_nvmf_subsystem_set_sn(subsystem, req->serial_number)) { 421 SPDK_ERRLOG("Subsystem %s: invalid serial number '%s'\n", req->nqn, req->serial_number); 422 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 423 "Invalid SN %s", req->serial_number); 424 goto cleanup; 425 } 426 } 427 428 if (req->model_number) { 429 if (spdk_nvmf_subsystem_set_mn(subsystem, req->model_number)) { 430 SPDK_ERRLOG("Subsystem %s: invalid model number '%s'\n", req->nqn, req->model_number); 431 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 432 "Invalid MN %s", req->model_number); 433 goto cleanup; 434 } 435 } 436 437 spdk_nvmf_subsystem_set_allow_any_host(subsystem, req->allow_any_host); 438 439 spdk_nvmf_subsystem_set_ana_reporting(subsystem, req->ana_reporting); 440 441 rc = spdk_nvmf_subsystem_start(subsystem, 442 rpc_nvmf_subsystem_started, 443 request); 444 445 cleanup: 446 free(req->nqn); 447 free(req->tgt_name); 448 free(req->serial_number); 449 free(req->model_number); 450 free(req); 451 452 if (rc && subsystem) { 453 spdk_nvmf_subsystem_destroy(subsystem); 454 } 455 } 456 SPDK_RPC_REGISTER("nvmf_create_subsystem", rpc_nvmf_create_subsystem, SPDK_RPC_RUNTIME) 457 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(nvmf_create_subsystem, nvmf_subsystem_create) 458 459 struct rpc_subsystem_set_options { 460 char *nqn; 461 char *tgt_name; 462 char *trtype; 463 }; 464 465 static const struct spdk_json_object_decoder rpc_subsystem_set_options_decoders[] = { 466 {"nqn", offsetof(struct rpc_subsystem_set_options, nqn), spdk_json_decode_string}, 467 {"tgt_name", offsetof(struct rpc_subsystem_set_options, tgt_name), spdk_json_decode_string, true}, 468 {"trtype", offsetof(struct rpc_subsystem_set_options, trtype), spdk_json_decode_string}, 469 }; 470 471 static void 472 rpc_nvmf_subsystem_set_options(struct spdk_jsonrpc_request *request, 473 const struct spdk_json_val *params) 474 { 475 struct rpc_subsystem_set_options *req; 476 struct spdk_nvmf_subsystem *subsystem; 477 struct spdk_nvmf_transport *transport; 478 struct spdk_json_write_ctx *w; 479 struct spdk_nvmf_tgt *tgt; 480 int rc; 481 482 req = calloc(1, sizeof(*req)); 483 if (!req) { 484 SPDK_ERRLOG("Memory allocation failed\n"); 485 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 486 "Memory allocation failed"); 487 return; 488 } 489 490 if (spdk_json_decode_object_relaxed(params, rpc_subsystem_set_options_decoders, 491 SPDK_COUNTOF(rpc_subsystem_set_options_decoders), req)) { 492 SPDK_ERRLOG("spdk_json_decode_object_relaxed failed\n"); 493 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 494 goto cleanup; 495 } 496 497 tgt = spdk_nvmf_get_tgt(req->tgt_name); 498 if (!tgt) { 499 SPDK_ERRLOG("Unable to find target %s\n", req->tgt_name); 500 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 501 "Unable to find target %s", req->tgt_name); 502 goto cleanup; 503 } 504 505 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, req->nqn); 506 if (!subsystem) { 507 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", req->nqn); 508 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 509 "Unable to find subsystem with NQN %s", req->nqn); 510 goto cleanup; 511 } 512 513 transport = spdk_nvmf_tgt_get_transport(tgt, req->trtype); 514 if (!transport) { 515 SPDK_ERRLOG("Unable to find transport with trtype %s\n", req->trtype); 516 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 517 "Unable to find transport with trtype %s", req->trtype); 518 goto cleanup; 519 } 520 521 if (!transport->ops->subsystem_opts_parse) { 522 SPDK_ERRLOG("Unable to find transport ops\n"); 523 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 524 "Unable to find transport ops"); 525 goto cleanup; 526 } 527 528 rc = transport->ops->subsystem_opts_parse(transport, subsystem, params); 529 if (rc) { 530 SPDK_ERRLOG("Unable to parse opts %d\n", rc); 531 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 532 "Unable to parse opts %d", rc); 533 goto cleanup; 534 } 535 536 w = spdk_jsonrpc_begin_result(request); 537 spdk_json_write_bool(w, true); 538 spdk_jsonrpc_end_result(request, w); 539 540 cleanup: 541 free(req->nqn); 542 free(req->tgt_name); 543 free(req->trtype); 544 free(req); 545 } 546 SPDK_RPC_REGISTER("nvmf_subsystem_set_options", rpc_nvmf_subsystem_set_options, SPDK_RPC_RUNTIME) 547 548 struct rpc_delete_subsystem { 549 char *nqn; 550 char *tgt_name; 551 }; 552 553 static void 554 free_rpc_delete_subsystem(struct rpc_delete_subsystem *r) 555 { 556 free(r->nqn); 557 free(r->tgt_name); 558 } 559 560 static void 561 rpc_nvmf_subsystem_stopped(struct spdk_nvmf_subsystem *subsystem, 562 void *cb_arg, int status) 563 { 564 struct spdk_jsonrpc_request *request = cb_arg; 565 struct spdk_json_write_ctx *w; 566 567 nvmf_subsystem_remove_all_listeners(subsystem, true); 568 spdk_nvmf_subsystem_destroy(subsystem); 569 570 w = spdk_jsonrpc_begin_result(request); 571 spdk_json_write_bool(w, true); 572 spdk_jsonrpc_end_result(request, w); 573 } 574 575 static const struct spdk_json_object_decoder rpc_delete_subsystem_decoders[] = { 576 {"nqn", offsetof(struct rpc_delete_subsystem, nqn), spdk_json_decode_string}, 577 {"tgt_name", offsetof(struct rpc_delete_subsystem, tgt_name), spdk_json_decode_string, true}, 578 }; 579 580 static void 581 rpc_nvmf_delete_subsystem(struct spdk_jsonrpc_request *request, 582 const struct spdk_json_val *params) 583 { 584 struct rpc_delete_subsystem req = { 0 }; 585 struct spdk_nvmf_subsystem *subsystem; 586 struct spdk_nvmf_tgt *tgt; 587 int rc; 588 589 if (spdk_json_decode_object(params, rpc_delete_subsystem_decoders, 590 SPDK_COUNTOF(rpc_delete_subsystem_decoders), 591 &req)) { 592 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 593 goto invalid; 594 } 595 596 if (req.nqn == NULL) { 597 SPDK_ERRLOG("missing name param\n"); 598 goto invalid; 599 } 600 601 tgt = spdk_nvmf_get_tgt(req.tgt_name); 602 if (!tgt) { 603 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 604 "Unable to find a target."); 605 goto invalid_custom_response; 606 } 607 608 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, req.nqn); 609 if (!subsystem) { 610 goto invalid; 611 } 612 613 free_rpc_delete_subsystem(&req); 614 615 rc = spdk_nvmf_subsystem_stop(subsystem, 616 rpc_nvmf_subsystem_stopped, 617 request); 618 if (rc == -EBUSY) { 619 SPDK_ERRLOG("Subsystem currently in another state change try again later.\n"); 620 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 621 "Subsystem currently in another state change try again later."); 622 } else if (rc != 0) { 623 SPDK_ERRLOG("Unable to change state on subsystem. rc=%d\n", rc); 624 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 625 "Unable to change state on subsystem. rc=%d", rc); 626 } 627 628 return; 629 630 invalid: 631 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 632 invalid_custom_response: 633 free_rpc_delete_subsystem(&req); 634 } 635 SPDK_RPC_REGISTER("nvmf_delete_subsystem", rpc_nvmf_delete_subsystem, SPDK_RPC_RUNTIME) 636 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(nvmf_delete_subsystem, delete_nvmf_subsystem) 637 638 struct rpc_listen_address { 639 char *transport; 640 char *adrfam; 641 char *traddr; 642 char *trsvcid; 643 }; 644 645 static const struct spdk_json_object_decoder rpc_listen_address_decoders[] = { 646 /* NOTE: "transport" is kept for compatibility; new code should use "trtype" */ 647 {"transport", offsetof(struct rpc_listen_address, transport), spdk_json_decode_string, true}, 648 {"trtype", offsetof(struct rpc_listen_address, transport), spdk_json_decode_string, true}, 649 {"adrfam", offsetof(struct rpc_listen_address, adrfam), spdk_json_decode_string, true}, 650 {"traddr", offsetof(struct rpc_listen_address, traddr), spdk_json_decode_string}, 651 {"trsvcid", offsetof(struct rpc_listen_address, trsvcid), spdk_json_decode_string}, 652 }; 653 654 static int 655 decode_rpc_listen_address(const struct spdk_json_val *val, void *out) 656 { 657 struct rpc_listen_address *req = (struct rpc_listen_address *)out; 658 if (spdk_json_decode_object(val, rpc_listen_address_decoders, 659 SPDK_COUNTOF(rpc_listen_address_decoders), 660 req)) { 661 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 662 return -1; 663 } 664 return 0; 665 } 666 667 static void 668 free_rpc_listen_address(struct rpc_listen_address *r) 669 { 670 free(r->transport); 671 free(r->adrfam); 672 free(r->traddr); 673 free(r->trsvcid); 674 } 675 676 enum nvmf_rpc_listen_op { 677 NVMF_RPC_LISTEN_ADD, 678 NVMF_RPC_LISTEN_REMOVE, 679 NVMF_RPC_LISTEN_SET_ANA_STATE, 680 }; 681 682 struct nvmf_rpc_listener_ctx { 683 char *nqn; 684 char *tgt_name; 685 struct spdk_nvmf_tgt *tgt; 686 struct spdk_nvmf_transport *transport; 687 struct spdk_nvmf_subsystem *subsystem; 688 struct rpc_listen_address address; 689 char *ana_state_str; 690 enum spdk_nvme_ana_state ana_state; 691 692 struct spdk_jsonrpc_request *request; 693 struct spdk_nvme_transport_id trid; 694 enum nvmf_rpc_listen_op op; 695 bool response_sent; 696 }; 697 698 static const struct spdk_json_object_decoder nvmf_rpc_listener_decoder[] = { 699 {"nqn", offsetof(struct nvmf_rpc_listener_ctx, nqn), spdk_json_decode_string}, 700 {"listen_address", offsetof(struct nvmf_rpc_listener_ctx, address), decode_rpc_listen_address}, 701 {"tgt_name", offsetof(struct nvmf_rpc_listener_ctx, tgt_name), spdk_json_decode_string, true}, 702 }; 703 704 static void 705 nvmf_rpc_listener_ctx_free(struct nvmf_rpc_listener_ctx *ctx) 706 { 707 free(ctx->nqn); 708 free(ctx->tgt_name); 709 free_rpc_listen_address(&ctx->address); 710 free(ctx->ana_state_str); 711 free(ctx); 712 } 713 714 static void 715 nvmf_rpc_listen_resumed(struct spdk_nvmf_subsystem *subsystem, 716 void *cb_arg, int status) 717 { 718 struct nvmf_rpc_listener_ctx *ctx = cb_arg; 719 struct spdk_jsonrpc_request *request; 720 struct spdk_json_write_ctx *w; 721 722 request = ctx->request; 723 if (ctx->response_sent) { 724 /* If an error occurred, the response has already been sent. */ 725 nvmf_rpc_listener_ctx_free(ctx); 726 return; 727 } 728 729 nvmf_rpc_listener_ctx_free(ctx); 730 731 w = spdk_jsonrpc_begin_result(request); 732 spdk_json_write_bool(w, true); 733 spdk_jsonrpc_end_result(request, w); 734 } 735 736 static void 737 nvmf_rpc_subsystem_listen(void *cb_arg, int status) 738 { 739 struct nvmf_rpc_listener_ctx *ctx = cb_arg; 740 741 if (status) { 742 /* Destroy the listener that we just created. Ignore the error code because 743 * the RPC is failing already anyway. */ 744 spdk_nvmf_tgt_stop_listen(ctx->tgt, &ctx->trid); 745 746 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 747 "Invalid parameters"); 748 ctx->response_sent = true; 749 } 750 751 if (spdk_nvmf_subsystem_resume(ctx->subsystem, nvmf_rpc_listen_resumed, ctx)) { 752 if (!ctx->response_sent) { 753 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 754 "Internal error"); 755 } 756 nvmf_rpc_listener_ctx_free(ctx); 757 /* Can't really do anything to recover here - subsystem will remain paused. */ 758 } 759 } 760 static void 761 nvmf_rpc_stop_listen_async_done(void *cb_arg, int status) 762 { 763 struct nvmf_rpc_listener_ctx *ctx = cb_arg; 764 765 if (status) { 766 SPDK_ERRLOG("Unable to stop listener.\n"); 767 spdk_jsonrpc_send_error_response_fmt(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 768 "error stopping listener: %d", status); 769 ctx->response_sent = true; 770 } 771 772 if (spdk_nvmf_subsystem_resume(ctx->subsystem, nvmf_rpc_listen_resumed, ctx)) { 773 if (!ctx->response_sent) { 774 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 775 "Internal error"); 776 } 777 nvmf_rpc_listener_ctx_free(ctx); 778 /* Can't really do anything to recover here - subsystem will remain paused. */ 779 } 780 } 781 782 static void 783 nvmf_rpc_set_ana_state_done(void *cb_arg, int status) 784 { 785 struct nvmf_rpc_listener_ctx *ctx = cb_arg; 786 787 if (status) { 788 SPDK_ERRLOG("Unable to set ANA state.\n"); 789 spdk_jsonrpc_send_error_response_fmt(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 790 "error setting ANA state: %d", status); 791 ctx->response_sent = true; 792 } 793 794 if (spdk_nvmf_subsystem_resume(ctx->subsystem, nvmf_rpc_listen_resumed, ctx)) { 795 if (!ctx->response_sent) { 796 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 797 "Internal error"); 798 } 799 nvmf_rpc_listener_ctx_free(ctx); 800 /* Can't really do anything to recover here - subsystem will remain paused. */ 801 } 802 } 803 804 static void 805 nvmf_rpc_listen_paused(struct spdk_nvmf_subsystem *subsystem, 806 void *cb_arg, int status) 807 { 808 struct nvmf_rpc_listener_ctx *ctx = cb_arg; 809 int rc; 810 811 if (ctx->op == NVMF_RPC_LISTEN_ADD) { 812 if (!nvmf_subsystem_find_listener(subsystem, &ctx->trid)) { 813 rc = spdk_nvmf_tgt_listen(ctx->tgt, &ctx->trid); 814 if (rc == 0) { 815 spdk_nvmf_subsystem_add_listener(ctx->subsystem, &ctx->trid, nvmf_rpc_subsystem_listen, ctx); 816 return; 817 } 818 819 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 820 "Invalid parameters"); 821 ctx->response_sent = true; 822 } 823 } else if (ctx->op == NVMF_RPC_LISTEN_REMOVE) { 824 if (spdk_nvmf_subsystem_remove_listener(subsystem, &ctx->trid)) { 825 SPDK_ERRLOG("Unable to remove listener.\n"); 826 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 827 "Invalid parameters"); 828 ctx->response_sent = true; 829 } 830 spdk_nvmf_transport_stop_listen_async(ctx->transport, &ctx->trid, nvmf_rpc_stop_listen_async_done, 831 ctx); 832 return; 833 } else if (ctx->op == NVMF_RPC_LISTEN_SET_ANA_STATE) { 834 nvmf_subsystem_set_ana_state(subsystem, &ctx->trid, ctx->ana_state, 835 nvmf_rpc_set_ana_state_done, ctx); 836 return; 837 } else { 838 SPDK_UNREACHABLE(); 839 } 840 841 if (spdk_nvmf_subsystem_resume(subsystem, nvmf_rpc_listen_resumed, ctx)) { 842 if (!ctx->response_sent) { 843 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 844 "Internal error"); 845 } 846 nvmf_rpc_listener_ctx_free(ctx); 847 /* Can't really do anything to recover here - subsystem will remain paused. */ 848 } 849 } 850 851 static int 852 rpc_listen_address_to_trid(const struct rpc_listen_address *address, 853 struct spdk_nvme_transport_id *trid) 854 { 855 size_t len; 856 857 memset(trid, 0, sizeof(*trid)); 858 859 if (spdk_nvme_transport_id_populate_trstring(trid, address->transport)) { 860 SPDK_ERRLOG("Invalid transport string: %s\n", address->transport); 861 return -EINVAL; 862 } 863 864 if (spdk_nvme_transport_id_parse_trtype(&trid->trtype, address->transport)) { 865 SPDK_ERRLOG("Invalid transport type: %s\n", address->transport); 866 return -EINVAL; 867 } 868 869 if (address->adrfam) { 870 if (spdk_nvme_transport_id_parse_adrfam(&trid->adrfam, address->adrfam)) { 871 SPDK_ERRLOG("Invalid adrfam: %s\n", address->adrfam); 872 return -EINVAL; 873 } 874 } else { 875 trid->adrfam = SPDK_NVMF_ADRFAM_IPV4; 876 } 877 878 len = strlen(address->traddr); 879 if (len > sizeof(trid->traddr) - 1) { 880 SPDK_ERRLOG("Transport address longer than %zu characters: %s\n", 881 sizeof(trid->traddr) - 1, address->traddr); 882 return -EINVAL; 883 } 884 memcpy(trid->traddr, address->traddr, len + 1); 885 886 len = strlen(address->trsvcid); 887 if (len > sizeof(trid->trsvcid) - 1) { 888 SPDK_ERRLOG("Transport service id longer than %zu characters: %s\n", 889 sizeof(trid->trsvcid) - 1, address->trsvcid); 890 return -EINVAL; 891 } 892 memcpy(trid->trsvcid, address->trsvcid, len + 1); 893 894 return 0; 895 } 896 897 static void 898 rpc_nvmf_subsystem_add_listener(struct spdk_jsonrpc_request *request, 899 const struct spdk_json_val *params) 900 { 901 struct nvmf_rpc_listener_ctx *ctx; 902 struct spdk_nvmf_subsystem *subsystem; 903 struct spdk_nvmf_tgt *tgt; 904 int rc; 905 906 ctx = calloc(1, sizeof(*ctx)); 907 if (!ctx) { 908 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Out of memory"); 909 return; 910 } 911 912 ctx->request = request; 913 914 if (spdk_json_decode_object(params, nvmf_rpc_listener_decoder, 915 SPDK_COUNTOF(nvmf_rpc_listener_decoder), 916 ctx)) { 917 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 918 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 919 nvmf_rpc_listener_ctx_free(ctx); 920 return; 921 } 922 923 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 924 if (!tgt) { 925 SPDK_ERRLOG("Unable to find a target object.\n"); 926 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 927 "Unable to find a target."); 928 nvmf_rpc_listener_ctx_free(ctx); 929 return; 930 } 931 ctx->tgt = tgt; 932 933 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx->nqn); 934 if (!subsystem) { 935 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx->nqn); 936 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 937 nvmf_rpc_listener_ctx_free(ctx); 938 return; 939 } 940 941 ctx->subsystem = subsystem; 942 943 if (rpc_listen_address_to_trid(&ctx->address, &ctx->trid)) { 944 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 945 "Invalid parameters"); 946 nvmf_rpc_listener_ctx_free(ctx); 947 return; 948 } 949 950 ctx->op = NVMF_RPC_LISTEN_ADD; 951 952 rc = spdk_nvmf_subsystem_pause(subsystem, nvmf_rpc_listen_paused, ctx); 953 if (rc != 0) { 954 if (rc == -EBUSY) { 955 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 956 "subsystem busy, retry later.\n"); 957 } else { 958 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 959 } 960 nvmf_rpc_listener_ctx_free(ctx); 961 } 962 } 963 SPDK_RPC_REGISTER("nvmf_subsystem_add_listener", rpc_nvmf_subsystem_add_listener, 964 SPDK_RPC_RUNTIME); 965 966 static void 967 rpc_nvmf_subsystem_remove_listener(struct spdk_jsonrpc_request *request, 968 const struct spdk_json_val *params) 969 { 970 struct nvmf_rpc_listener_ctx *ctx; 971 struct spdk_nvmf_subsystem *subsystem; 972 struct spdk_nvmf_tgt *tgt; 973 int rc; 974 975 ctx = calloc(1, sizeof(*ctx)); 976 if (!ctx) { 977 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Out of memory"); 978 return; 979 } 980 981 ctx->request = request; 982 983 if (spdk_json_decode_object(params, nvmf_rpc_listener_decoder, 984 SPDK_COUNTOF(nvmf_rpc_listener_decoder), 985 ctx)) { 986 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 987 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 988 nvmf_rpc_listener_ctx_free(ctx); 989 return; 990 } 991 992 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 993 if (!tgt) { 994 SPDK_ERRLOG("Unable to find a target object.\n"); 995 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 996 "Unable to find a target."); 997 nvmf_rpc_listener_ctx_free(ctx); 998 return; 999 } 1000 ctx->tgt = tgt; 1001 1002 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx->nqn); 1003 if (!subsystem) { 1004 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx->nqn); 1005 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1006 nvmf_rpc_listener_ctx_free(ctx); 1007 return; 1008 } 1009 1010 ctx->subsystem = subsystem; 1011 1012 if (rpc_listen_address_to_trid(&ctx->address, &ctx->trid)) { 1013 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1014 "Invalid parameters"); 1015 nvmf_rpc_listener_ctx_free(ctx); 1016 return; 1017 } 1018 1019 ctx->transport = spdk_nvmf_tgt_get_transport(tgt, ctx->trid.trstring); 1020 if (!ctx->transport) { 1021 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1022 "Invalid parameters"); 1023 nvmf_rpc_listener_ctx_free(ctx); 1024 return; 1025 } 1026 1027 ctx->op = NVMF_RPC_LISTEN_REMOVE; 1028 1029 rc = spdk_nvmf_subsystem_pause(subsystem, nvmf_rpc_listen_paused, ctx); 1030 if (rc != 0) { 1031 if (rc == -EBUSY) { 1032 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1033 "subsystem busy, retry later.\n"); 1034 } else { 1035 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1036 } 1037 nvmf_rpc_listener_ctx_free(ctx); 1038 } 1039 } 1040 SPDK_RPC_REGISTER("nvmf_subsystem_remove_listener", rpc_nvmf_subsystem_remove_listener, 1041 SPDK_RPC_RUNTIME); 1042 1043 static const struct spdk_json_object_decoder nvmf_rpc_set_ana_state_decoder[] = { 1044 {"nqn", offsetof(struct nvmf_rpc_listener_ctx, nqn), spdk_json_decode_string}, 1045 {"listen_address", offsetof(struct nvmf_rpc_listener_ctx, address), decode_rpc_listen_address}, 1046 {"ana_state", offsetof(struct nvmf_rpc_listener_ctx, ana_state_str), spdk_json_decode_string}, 1047 {"tgt_name", offsetof(struct nvmf_rpc_listener_ctx, tgt_name), spdk_json_decode_string, true}, 1048 }; 1049 1050 static int 1051 rpc_ana_state_parse(const char *str, enum spdk_nvme_ana_state *ana_state) 1052 { 1053 if (ana_state == NULL || str == NULL) { 1054 return -EINVAL; 1055 } 1056 1057 if (strcasecmp(str, "optimized") == 0) { 1058 *ana_state = SPDK_NVME_ANA_OPTIMIZED_STATE; 1059 } else if (strcasecmp(str, "non_optimized") == 0) { 1060 *ana_state = SPDK_NVME_ANA_NON_OPTIMIZED_STATE; 1061 } else if (strcasecmp(str, "inaccessible") == 0) { 1062 *ana_state = SPDK_NVME_ANA_INACCESSIBLE_STATE; 1063 } else { 1064 return -ENOENT; 1065 } 1066 1067 return 0; 1068 } 1069 1070 static void 1071 rpc_nvmf_subsystem_listener_set_ana_state(struct spdk_jsonrpc_request *request, 1072 const struct spdk_json_val *params) 1073 { 1074 struct nvmf_rpc_listener_ctx *ctx; 1075 struct spdk_nvmf_subsystem *subsystem; 1076 struct spdk_nvmf_tgt *tgt; 1077 1078 ctx = calloc(1, sizeof(*ctx)); 1079 if (!ctx) { 1080 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1081 "Out of memory"); 1082 return; 1083 } 1084 1085 ctx->request = request; 1086 1087 if (spdk_json_decode_object(params, nvmf_rpc_set_ana_state_decoder, 1088 SPDK_COUNTOF(nvmf_rpc_set_ana_state_decoder), 1089 ctx)) { 1090 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1091 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1092 "Invalid parameters"); 1093 nvmf_rpc_listener_ctx_free(ctx); 1094 return; 1095 } 1096 1097 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 1098 if (!tgt) { 1099 SPDK_ERRLOG("Unable to find a target object.\n"); 1100 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1101 "Unable to find a target.\n"); 1102 nvmf_rpc_listener_ctx_free(ctx); 1103 return; 1104 } 1105 1106 ctx->tgt = tgt; 1107 1108 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx->nqn); 1109 if (!subsystem) { 1110 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx->nqn); 1111 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1112 "Unable to find subsystem with NQN %s", 1113 ctx->nqn); 1114 nvmf_rpc_listener_ctx_free(ctx); 1115 return; 1116 } 1117 1118 ctx->subsystem = subsystem; 1119 1120 if (rpc_listen_address_to_trid(&ctx->address, &ctx->trid)) { 1121 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1122 "Invalid parameters"); 1123 nvmf_rpc_listener_ctx_free(ctx); 1124 return; 1125 } 1126 1127 if (rpc_ana_state_parse(ctx->ana_state_str, &ctx->ana_state)) { 1128 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1129 "Invalid parameters"); 1130 nvmf_rpc_listener_ctx_free(ctx); 1131 return; 1132 } 1133 1134 ctx->op = NVMF_RPC_LISTEN_SET_ANA_STATE; 1135 1136 if (spdk_nvmf_subsystem_pause(subsystem, nvmf_rpc_listen_paused, ctx)) { 1137 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1138 "Internal error"); 1139 nvmf_rpc_listener_ctx_free(ctx); 1140 } 1141 } 1142 SPDK_RPC_REGISTER("nvmf_subsystem_listener_set_ana_state", 1143 rpc_nvmf_subsystem_listener_set_ana_state, SPDK_RPC_RUNTIME); 1144 1145 struct spdk_nvmf_ns_params { 1146 char *bdev_name; 1147 char *ptpl_file; 1148 uint32_t nsid; 1149 char nguid[16]; 1150 char eui64[8]; 1151 struct spdk_uuid uuid; 1152 }; 1153 1154 static const struct spdk_json_object_decoder rpc_ns_params_decoders[] = { 1155 {"nsid", offsetof(struct spdk_nvmf_ns_params, nsid), spdk_json_decode_uint32, true}, 1156 {"bdev_name", offsetof(struct spdk_nvmf_ns_params, bdev_name), spdk_json_decode_string}, 1157 {"ptpl_file", offsetof(struct spdk_nvmf_ns_params, ptpl_file), spdk_json_decode_string, true}, 1158 {"nguid", offsetof(struct spdk_nvmf_ns_params, nguid), decode_ns_nguid, true}, 1159 {"eui64", offsetof(struct spdk_nvmf_ns_params, eui64), decode_ns_eui64, true}, 1160 {"uuid", offsetof(struct spdk_nvmf_ns_params, uuid), decode_ns_uuid, true}, 1161 }; 1162 1163 static int 1164 decode_rpc_ns_params(const struct spdk_json_val *val, void *out) 1165 { 1166 struct spdk_nvmf_ns_params *ns_params = out; 1167 1168 return spdk_json_decode_object(val, rpc_ns_params_decoders, 1169 SPDK_COUNTOF(rpc_ns_params_decoders), 1170 ns_params); 1171 } 1172 1173 struct nvmf_rpc_ns_ctx { 1174 char *nqn; 1175 char *tgt_name; 1176 struct spdk_nvmf_ns_params ns_params; 1177 1178 struct spdk_jsonrpc_request *request; 1179 bool response_sent; 1180 }; 1181 1182 static const struct spdk_json_object_decoder nvmf_rpc_subsystem_ns_decoder[] = { 1183 {"nqn", offsetof(struct nvmf_rpc_ns_ctx, nqn), spdk_json_decode_string}, 1184 {"namespace", offsetof(struct nvmf_rpc_ns_ctx, ns_params), decode_rpc_ns_params}, 1185 {"tgt_name", offsetof(struct nvmf_rpc_ns_ctx, tgt_name), spdk_json_decode_string, true}, 1186 }; 1187 1188 static void 1189 nvmf_rpc_ns_ctx_free(struct nvmf_rpc_ns_ctx *ctx) 1190 { 1191 free(ctx->nqn); 1192 free(ctx->tgt_name); 1193 free(ctx->ns_params.bdev_name); 1194 free(ctx->ns_params.ptpl_file); 1195 free(ctx); 1196 } 1197 1198 static void 1199 nvmf_rpc_ns_failback_resumed(struct spdk_nvmf_subsystem *subsystem, 1200 void *cb_arg, int status) 1201 { 1202 struct nvmf_rpc_ns_ctx *ctx = cb_arg; 1203 struct spdk_jsonrpc_request *request = ctx->request; 1204 1205 if (status) { 1206 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1207 "Unable to add ns, subsystem in invalid state"); 1208 } else { 1209 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1210 "Unable to add ns, subsystem in active state"); 1211 } 1212 1213 nvmf_rpc_ns_ctx_free(ctx); 1214 } 1215 1216 static void 1217 nvmf_rpc_ns_resumed(struct spdk_nvmf_subsystem *subsystem, 1218 void *cb_arg, int status) 1219 { 1220 struct nvmf_rpc_ns_ctx *ctx = cb_arg; 1221 struct spdk_jsonrpc_request *request = ctx->request; 1222 uint32_t nsid = ctx->ns_params.nsid; 1223 bool response_sent = ctx->response_sent; 1224 struct spdk_json_write_ctx *w; 1225 int rc; 1226 1227 /* The case where the call to add the namespace was successful, but the subsystem couldn't be resumed. */ 1228 if (status && !ctx->response_sent) { 1229 rc = spdk_nvmf_subsystem_remove_ns(subsystem, nsid); 1230 if (rc != 0) { 1231 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1232 "Unable to add ns, subsystem in invalid state"); 1233 nvmf_rpc_ns_ctx_free(ctx); 1234 return; 1235 } 1236 1237 rc = spdk_nvmf_subsystem_resume(subsystem, nvmf_rpc_ns_failback_resumed, ctx); 1238 if (rc != 0) { 1239 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1240 nvmf_rpc_ns_ctx_free(ctx); 1241 return; 1242 } 1243 1244 return; 1245 } 1246 1247 nvmf_rpc_ns_ctx_free(ctx); 1248 1249 if (response_sent) { 1250 return; 1251 } 1252 1253 w = spdk_jsonrpc_begin_result(request); 1254 spdk_json_write_uint32(w, nsid); 1255 spdk_jsonrpc_end_result(request, w); 1256 } 1257 1258 static void 1259 nvmf_rpc_ns_paused(struct spdk_nvmf_subsystem *subsystem, 1260 void *cb_arg, int status) 1261 { 1262 struct nvmf_rpc_ns_ctx *ctx = cb_arg; 1263 struct spdk_nvmf_ns_opts ns_opts; 1264 1265 spdk_nvmf_ns_opts_get_defaults(&ns_opts, sizeof(ns_opts)); 1266 ns_opts.nsid = ctx->ns_params.nsid; 1267 1268 SPDK_STATIC_ASSERT(sizeof(ns_opts.nguid) == sizeof(ctx->ns_params.nguid), "size mismatch"); 1269 memcpy(ns_opts.nguid, ctx->ns_params.nguid, sizeof(ns_opts.nguid)); 1270 1271 SPDK_STATIC_ASSERT(sizeof(ns_opts.eui64) == sizeof(ctx->ns_params.eui64), "size mismatch"); 1272 memcpy(ns_opts.eui64, ctx->ns_params.eui64, sizeof(ns_opts.eui64)); 1273 1274 if (!spdk_mem_all_zero(&ctx->ns_params.uuid, sizeof(ctx->ns_params.uuid))) { 1275 ns_opts.uuid = ctx->ns_params.uuid; 1276 } 1277 1278 ctx->ns_params.nsid = spdk_nvmf_subsystem_add_ns_ext(subsystem, ctx->ns_params.bdev_name, 1279 &ns_opts, sizeof(ns_opts), 1280 ctx->ns_params.ptpl_file); 1281 if (ctx->ns_params.nsid == 0) { 1282 SPDK_ERRLOG("Unable to add namespace\n"); 1283 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1284 "Invalid parameters"); 1285 ctx->response_sent = true; 1286 goto resume; 1287 } 1288 1289 resume: 1290 if (spdk_nvmf_subsystem_resume(subsystem, nvmf_rpc_ns_resumed, ctx)) { 1291 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1292 nvmf_rpc_ns_ctx_free(ctx); 1293 } 1294 } 1295 1296 static void 1297 rpc_nvmf_subsystem_add_ns(struct spdk_jsonrpc_request *request, 1298 const struct spdk_json_val *params) 1299 { 1300 struct nvmf_rpc_ns_ctx *ctx; 1301 struct spdk_nvmf_subsystem *subsystem; 1302 struct spdk_nvmf_tgt *tgt; 1303 int rc; 1304 1305 ctx = calloc(1, sizeof(*ctx)); 1306 if (!ctx) { 1307 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Out of memory"); 1308 return; 1309 } 1310 1311 if (spdk_json_decode_object(params, nvmf_rpc_subsystem_ns_decoder, 1312 SPDK_COUNTOF(nvmf_rpc_subsystem_ns_decoder), 1313 ctx)) { 1314 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1315 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1316 nvmf_rpc_ns_ctx_free(ctx); 1317 return; 1318 } 1319 1320 ctx->request = request; 1321 ctx->response_sent = false; 1322 1323 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 1324 if (!tgt) { 1325 SPDK_ERRLOG("Unable to find a target object.\n"); 1326 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1327 "Unable to find a target."); 1328 nvmf_rpc_ns_ctx_free(ctx); 1329 return; 1330 } 1331 1332 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx->nqn); 1333 if (!subsystem) { 1334 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx->nqn); 1335 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1336 nvmf_rpc_ns_ctx_free(ctx); 1337 return; 1338 } 1339 1340 rc = spdk_nvmf_subsystem_pause(subsystem, nvmf_rpc_ns_paused, ctx); 1341 if (rc != 0) { 1342 if (rc == -EBUSY) { 1343 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1344 "subsystem busy, retry later.\n"); 1345 } else { 1346 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1347 } 1348 nvmf_rpc_ns_ctx_free(ctx); 1349 } 1350 } 1351 SPDK_RPC_REGISTER("nvmf_subsystem_add_ns", rpc_nvmf_subsystem_add_ns, SPDK_RPC_RUNTIME) 1352 1353 struct nvmf_rpc_remove_ns_ctx { 1354 char *nqn; 1355 char *tgt_name; 1356 uint32_t nsid; 1357 1358 struct spdk_jsonrpc_request *request; 1359 bool response_sent; 1360 }; 1361 1362 static const struct spdk_json_object_decoder nvmf_rpc_subsystem_remove_ns_decoder[] = { 1363 {"nqn", offsetof(struct nvmf_rpc_remove_ns_ctx, nqn), spdk_json_decode_string}, 1364 {"nsid", offsetof(struct nvmf_rpc_remove_ns_ctx, nsid), spdk_json_decode_uint32}, 1365 {"tgt_name", offsetof(struct nvmf_rpc_remove_ns_ctx, tgt_name), spdk_json_decode_string, true}, 1366 }; 1367 1368 static void 1369 nvmf_rpc_remove_ns_ctx_free(struct nvmf_rpc_remove_ns_ctx *ctx) 1370 { 1371 free(ctx->nqn); 1372 free(ctx->tgt_name); 1373 free(ctx); 1374 } 1375 1376 static void 1377 nvmf_rpc_remove_ns_resumed(struct spdk_nvmf_subsystem *subsystem, 1378 void *cb_arg, int status) 1379 { 1380 struct nvmf_rpc_remove_ns_ctx *ctx = cb_arg; 1381 struct spdk_jsonrpc_request *request = ctx->request; 1382 bool response_sent = ctx->response_sent; 1383 struct spdk_json_write_ctx *w; 1384 1385 nvmf_rpc_remove_ns_ctx_free(ctx); 1386 1387 if (response_sent) { 1388 return; 1389 } 1390 1391 w = spdk_jsonrpc_begin_result(request); 1392 spdk_json_write_bool(w, true); 1393 spdk_jsonrpc_end_result(request, w); 1394 } 1395 1396 static void 1397 nvmf_rpc_remove_ns_paused(struct spdk_nvmf_subsystem *subsystem, 1398 void *cb_arg, int status) 1399 { 1400 struct nvmf_rpc_remove_ns_ctx *ctx = cb_arg; 1401 int ret; 1402 1403 ret = spdk_nvmf_subsystem_remove_ns(subsystem, ctx->nsid); 1404 if (ret < 0) { 1405 SPDK_ERRLOG("Unable to remove namespace ID %u\n", ctx->nsid); 1406 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1407 "Invalid parameters"); 1408 ctx->response_sent = true; 1409 } 1410 1411 if (spdk_nvmf_subsystem_resume(subsystem, nvmf_rpc_remove_ns_resumed, ctx)) { 1412 if (!ctx->response_sent) { 1413 spdk_jsonrpc_send_error_response(ctx->request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1414 } 1415 nvmf_rpc_remove_ns_ctx_free(ctx); 1416 } 1417 } 1418 1419 static void 1420 rpc_nvmf_subsystem_remove_ns(struct spdk_jsonrpc_request *request, 1421 const struct spdk_json_val *params) 1422 { 1423 struct nvmf_rpc_remove_ns_ctx *ctx; 1424 struct spdk_nvmf_subsystem *subsystem; 1425 struct spdk_nvmf_tgt *tgt; 1426 int rc; 1427 1428 ctx = calloc(1, sizeof(*ctx)); 1429 if (!ctx) { 1430 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Out of memory"); 1431 return; 1432 } 1433 1434 if (spdk_json_decode_object(params, nvmf_rpc_subsystem_remove_ns_decoder, 1435 SPDK_COUNTOF(nvmf_rpc_subsystem_remove_ns_decoder), 1436 ctx)) { 1437 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1438 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1439 nvmf_rpc_remove_ns_ctx_free(ctx); 1440 return; 1441 } 1442 1443 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 1444 if (!tgt) { 1445 SPDK_ERRLOG("Unable to find a target object.\n"); 1446 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1447 "Unable to find a target."); 1448 nvmf_rpc_remove_ns_ctx_free(ctx); 1449 return; 1450 } 1451 1452 ctx->request = request; 1453 ctx->response_sent = false; 1454 1455 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx->nqn); 1456 if (!subsystem) { 1457 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx->nqn); 1458 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1459 nvmf_rpc_remove_ns_ctx_free(ctx); 1460 return; 1461 } 1462 1463 rc = spdk_nvmf_subsystem_pause(subsystem, nvmf_rpc_remove_ns_paused, ctx); 1464 if (rc != 0) { 1465 if (rc == -EBUSY) { 1466 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1467 "subsystem busy, retry later.\n"); 1468 } else { 1469 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1470 } 1471 nvmf_rpc_remove_ns_ctx_free(ctx); 1472 } 1473 } 1474 SPDK_RPC_REGISTER("nvmf_subsystem_remove_ns", rpc_nvmf_subsystem_remove_ns, SPDK_RPC_RUNTIME) 1475 1476 struct nvmf_rpc_host_ctx { 1477 char *nqn; 1478 char *host; 1479 char *tgt_name; 1480 bool allow_any_host; 1481 }; 1482 1483 static const struct spdk_json_object_decoder nvmf_rpc_subsystem_host_decoder[] = { 1484 {"nqn", offsetof(struct nvmf_rpc_host_ctx, nqn), spdk_json_decode_string}, 1485 {"host", offsetof(struct nvmf_rpc_host_ctx, host), spdk_json_decode_string}, 1486 {"tgt_name", offsetof(struct nvmf_rpc_host_ctx, tgt_name), spdk_json_decode_string, true}, 1487 }; 1488 1489 static void 1490 nvmf_rpc_host_ctx_free(struct nvmf_rpc_host_ctx *ctx) 1491 { 1492 free(ctx->nqn); 1493 free(ctx->host); 1494 free(ctx->tgt_name); 1495 } 1496 1497 static void 1498 rpc_nvmf_subsystem_add_host(struct spdk_jsonrpc_request *request, 1499 const struct spdk_json_val *params) 1500 { 1501 struct nvmf_rpc_host_ctx ctx = {}; 1502 struct spdk_nvmf_subsystem *subsystem; 1503 struct spdk_nvmf_tgt *tgt; 1504 struct spdk_json_write_ctx *w; 1505 int rc; 1506 1507 if (spdk_json_decode_object(params, nvmf_rpc_subsystem_host_decoder, 1508 SPDK_COUNTOF(nvmf_rpc_subsystem_host_decoder), 1509 &ctx)) { 1510 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1511 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1512 nvmf_rpc_host_ctx_free(&ctx); 1513 return; 1514 } 1515 1516 tgt = spdk_nvmf_get_tgt(ctx.tgt_name); 1517 if (!tgt) { 1518 SPDK_ERRLOG("Unable to find a target object.\n"); 1519 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1520 "Unable to find a target."); 1521 nvmf_rpc_host_ctx_free(&ctx); 1522 return; 1523 } 1524 1525 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx.nqn); 1526 if (!subsystem) { 1527 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx.nqn); 1528 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1529 nvmf_rpc_host_ctx_free(&ctx); 1530 return; 1531 } 1532 1533 rc = spdk_nvmf_subsystem_add_host(subsystem, ctx.host); 1534 if (rc != 0) { 1535 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1536 nvmf_rpc_host_ctx_free(&ctx); 1537 return; 1538 } 1539 1540 w = spdk_jsonrpc_begin_result(request); 1541 spdk_json_write_bool(w, true); 1542 spdk_jsonrpc_end_result(request, w); 1543 nvmf_rpc_host_ctx_free(&ctx); 1544 } 1545 SPDK_RPC_REGISTER("nvmf_subsystem_add_host", rpc_nvmf_subsystem_add_host, SPDK_RPC_RUNTIME) 1546 1547 static void 1548 rpc_nvmf_subsystem_remove_host(struct spdk_jsonrpc_request *request, 1549 const struct spdk_json_val *params) 1550 { 1551 struct nvmf_rpc_host_ctx ctx = {}; 1552 struct spdk_nvmf_subsystem *subsystem; 1553 struct spdk_nvmf_tgt *tgt; 1554 struct spdk_json_write_ctx *w; 1555 int rc; 1556 1557 if (spdk_json_decode_object(params, nvmf_rpc_subsystem_host_decoder, 1558 SPDK_COUNTOF(nvmf_rpc_subsystem_host_decoder), 1559 &ctx)) { 1560 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1561 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1562 nvmf_rpc_host_ctx_free(&ctx); 1563 return; 1564 } 1565 1566 tgt = spdk_nvmf_get_tgt(ctx.tgt_name); 1567 if (!tgt) { 1568 SPDK_ERRLOG("Unable to find a target object.\n"); 1569 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1570 "Unable to find a target."); 1571 nvmf_rpc_host_ctx_free(&ctx); 1572 return; 1573 } 1574 1575 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx.nqn); 1576 if (!subsystem) { 1577 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx.nqn); 1578 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1579 nvmf_rpc_host_ctx_free(&ctx); 1580 return; 1581 } 1582 1583 rc = spdk_nvmf_subsystem_remove_host(subsystem, ctx.host); 1584 if (rc != 0) { 1585 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1586 nvmf_rpc_host_ctx_free(&ctx); 1587 return; 1588 } 1589 1590 w = spdk_jsonrpc_begin_result(request); 1591 spdk_json_write_bool(w, true); 1592 spdk_jsonrpc_end_result(request, w); 1593 nvmf_rpc_host_ctx_free(&ctx); 1594 } 1595 SPDK_RPC_REGISTER("nvmf_subsystem_remove_host", rpc_nvmf_subsystem_remove_host, 1596 SPDK_RPC_RUNTIME) 1597 1598 1599 static const struct spdk_json_object_decoder nvmf_rpc_subsystem_any_host_decoder[] = { 1600 {"nqn", offsetof(struct nvmf_rpc_host_ctx, nqn), spdk_json_decode_string}, 1601 {"allow_any_host", offsetof(struct nvmf_rpc_host_ctx, allow_any_host), spdk_json_decode_bool}, 1602 {"tgt_name", offsetof(struct nvmf_rpc_host_ctx, tgt_name), spdk_json_decode_string, true}, 1603 }; 1604 1605 static void 1606 rpc_nvmf_subsystem_allow_any_host(struct spdk_jsonrpc_request *request, 1607 const struct spdk_json_val *params) 1608 { 1609 struct nvmf_rpc_host_ctx ctx = {}; 1610 struct spdk_nvmf_subsystem *subsystem; 1611 struct spdk_nvmf_tgt *tgt; 1612 struct spdk_json_write_ctx *w; 1613 int rc; 1614 1615 if (spdk_json_decode_object(params, nvmf_rpc_subsystem_any_host_decoder, 1616 SPDK_COUNTOF(nvmf_rpc_subsystem_any_host_decoder), 1617 &ctx)) { 1618 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1619 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1620 nvmf_rpc_host_ctx_free(&ctx); 1621 return; 1622 } 1623 1624 tgt = spdk_nvmf_get_tgt(ctx.tgt_name); 1625 if (!tgt) { 1626 SPDK_ERRLOG("Unable to find a target object.\n"); 1627 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1628 "Unable to find a target."); 1629 nvmf_rpc_host_ctx_free(&ctx); 1630 return; 1631 } 1632 1633 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx.nqn); 1634 if (!subsystem) { 1635 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx.nqn); 1636 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1637 nvmf_rpc_host_ctx_free(&ctx); 1638 return; 1639 } 1640 1641 rc = spdk_nvmf_subsystem_set_allow_any_host(subsystem, ctx.allow_any_host); 1642 if (rc != 0) { 1643 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Internal error"); 1644 nvmf_rpc_host_ctx_free(&ctx); 1645 return; 1646 } 1647 1648 w = spdk_jsonrpc_begin_result(request); 1649 spdk_json_write_bool(w, true); 1650 spdk_jsonrpc_end_result(request, w); 1651 nvmf_rpc_host_ctx_free(&ctx); 1652 } 1653 SPDK_RPC_REGISTER("nvmf_subsystem_allow_any_host", rpc_nvmf_subsystem_allow_any_host, 1654 SPDK_RPC_RUNTIME) 1655 1656 struct nvmf_rpc_target_ctx { 1657 char *name; 1658 uint32_t max_subsystems; 1659 }; 1660 1661 static const struct spdk_json_object_decoder nvmf_rpc_create_target_decoder[] = { 1662 {"name", offsetof(struct nvmf_rpc_target_ctx, name), spdk_json_decode_string}, 1663 {"max_subsystems", offsetof(struct nvmf_rpc_target_ctx, max_subsystems), spdk_json_decode_uint32, true}, 1664 }; 1665 1666 static void 1667 rpc_nvmf_create_target(struct spdk_jsonrpc_request *request, 1668 const struct spdk_json_val *params) 1669 { 1670 struct spdk_nvmf_target_opts opts; 1671 struct nvmf_rpc_target_ctx ctx = {0}; 1672 struct spdk_nvmf_tgt *tgt; 1673 struct spdk_json_write_ctx *w; 1674 1675 /* Decode parameters the first time to get the transport type */ 1676 if (spdk_json_decode_object(params, nvmf_rpc_create_target_decoder, 1677 SPDK_COUNTOF(nvmf_rpc_create_target_decoder), 1678 &ctx)) { 1679 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1680 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1681 free(ctx.name); 1682 return; 1683 } 1684 1685 snprintf(opts.name, NVMF_TGT_NAME_MAX_LENGTH, "%s", ctx.name); 1686 opts.max_subsystems = ctx.max_subsystems; 1687 1688 if (spdk_nvmf_get_tgt(opts.name) != NULL) { 1689 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1690 "Target already exists."); 1691 free(ctx.name); 1692 return; 1693 } 1694 1695 tgt = spdk_nvmf_tgt_create(&opts); 1696 1697 if (tgt == NULL) { 1698 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1699 "Unable to create the requested target."); 1700 free(ctx.name); 1701 return; 1702 } 1703 1704 w = spdk_jsonrpc_begin_result(request); 1705 spdk_json_write_string(w, spdk_nvmf_tgt_get_name(tgt)); 1706 spdk_jsonrpc_end_result(request, w); 1707 free(ctx.name); 1708 } 1709 SPDK_RPC_REGISTER("nvmf_create_target", rpc_nvmf_create_target, SPDK_RPC_RUNTIME); 1710 1711 static const struct spdk_json_object_decoder nvmf_rpc_destroy_target_decoder[] = { 1712 {"name", offsetof(struct nvmf_rpc_target_ctx, name), spdk_json_decode_string}, 1713 }; 1714 1715 static void 1716 nvmf_rpc_destroy_target_done(void *ctx, int status) 1717 { 1718 struct spdk_jsonrpc_request *request = ctx; 1719 struct spdk_json_write_ctx *w; 1720 1721 w = spdk_jsonrpc_begin_result(request); 1722 spdk_json_write_bool(w, true); 1723 spdk_jsonrpc_end_result(request, w); 1724 } 1725 1726 static void 1727 rpc_nvmf_delete_target(struct spdk_jsonrpc_request *request, 1728 const struct spdk_json_val *params) 1729 { 1730 struct nvmf_rpc_target_ctx ctx = {0}; 1731 struct spdk_nvmf_tgt *tgt; 1732 1733 /* Decode parameters the first time to get the transport type */ 1734 if (spdk_json_decode_object(params, nvmf_rpc_destroy_target_decoder, 1735 SPDK_COUNTOF(nvmf_rpc_destroy_target_decoder), 1736 &ctx)) { 1737 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 1738 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1739 free(ctx.name); 1740 return; 1741 } 1742 1743 tgt = spdk_nvmf_get_tgt(ctx.name); 1744 1745 if (tgt == NULL) { 1746 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1747 "The specified target doesn't exist, cannot delete it."); 1748 free(ctx.name); 1749 return; 1750 } 1751 1752 spdk_nvmf_tgt_destroy(tgt, nvmf_rpc_destroy_target_done, request); 1753 free(ctx.name); 1754 } 1755 SPDK_RPC_REGISTER("nvmf_delete_target", rpc_nvmf_delete_target, SPDK_RPC_RUNTIME); 1756 1757 static void 1758 rpc_nvmf_get_targets(struct spdk_jsonrpc_request *request, 1759 const struct spdk_json_val *params) 1760 { 1761 struct spdk_json_write_ctx *w; 1762 struct spdk_nvmf_tgt *tgt; 1763 const char *name; 1764 1765 if (params != NULL) { 1766 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1767 "nvmf_get_targets has no parameters."); 1768 return; 1769 } 1770 1771 w = spdk_jsonrpc_begin_result(request); 1772 spdk_json_write_array_begin(w); 1773 1774 tgt = spdk_nvmf_get_first_tgt(); 1775 1776 while (tgt != NULL) { 1777 name = spdk_nvmf_tgt_get_name(tgt); 1778 spdk_json_write_string(w, name); 1779 tgt = spdk_nvmf_get_next_tgt(tgt); 1780 } 1781 1782 spdk_json_write_array_end(w); 1783 spdk_jsonrpc_end_result(request, w); 1784 } 1785 SPDK_RPC_REGISTER("nvmf_get_targets", rpc_nvmf_get_targets, SPDK_RPC_RUNTIME); 1786 1787 struct nvmf_rpc_create_transport_ctx { 1788 char *trtype; 1789 char *tgt_name; 1790 struct spdk_nvmf_transport_opts opts; 1791 struct spdk_jsonrpc_request *request; 1792 }; 1793 1794 /** 1795 * `max_qpairs_per_ctrlr` represents both admin and IO qpairs, that confuses 1796 * users when they configure a transport using RPC. So it was decided to 1797 * deprecate `max_qpairs_per_ctrlr` RPC parameter and use `max_io_qpairs_per_ctrlr` 1798 * But internal logic remains unchanged and SPDK expects that 1799 * spdk_nvmf_transport_opts::max_qpairs_per_ctrlr includes an admin qpair. 1800 * This function parses the number of IO qpairs and adds +1 for admin qpair. 1801 */ 1802 static int 1803 nvmf_rpc_decode_max_io_qpairs(const struct spdk_json_val *val, void *out) 1804 { 1805 uint16_t *i = out; 1806 int rc; 1807 1808 rc = spdk_json_number_to_uint16(val, i); 1809 if (rc == 0) { 1810 (*i)++; 1811 } 1812 1813 return rc; 1814 } 1815 1816 /** 1817 * This function parses deprecated `max_qpairs_per_ctrlr` and warns the user to use 1818 * the new parameter `max_io_qpairs_per_ctrlr` 1819 */ 1820 static int 1821 nvmf_rpc_decode_max_qpairs(const struct spdk_json_val *val, void *out) 1822 { 1823 uint16_t *i = out; 1824 int rc; 1825 1826 rc = spdk_json_number_to_uint16(val, i); 1827 if (rc == 0) { 1828 SPDK_WARNLOG("Parameter max_qpairs_per_ctrlr is deprecated, use max_io_qpairs_per_ctrlr instead.\n"); 1829 } 1830 1831 return rc; 1832 } 1833 1834 static const struct spdk_json_object_decoder nvmf_rpc_create_transport_decoder[] = { 1835 { "trtype", offsetof(struct nvmf_rpc_create_transport_ctx, trtype), spdk_json_decode_string}, 1836 { 1837 "max_queue_depth", offsetof(struct nvmf_rpc_create_transport_ctx, opts.max_queue_depth), 1838 spdk_json_decode_uint16, true 1839 }, 1840 { 1841 "max_qpairs_per_ctrlr", offsetof(struct nvmf_rpc_create_transport_ctx, opts.max_qpairs_per_ctrlr), 1842 nvmf_rpc_decode_max_qpairs, true 1843 }, 1844 { 1845 "max_io_qpairs_per_ctrlr", offsetof(struct nvmf_rpc_create_transport_ctx, opts.max_qpairs_per_ctrlr), 1846 nvmf_rpc_decode_max_io_qpairs, true 1847 }, 1848 { 1849 "in_capsule_data_size", offsetof(struct nvmf_rpc_create_transport_ctx, opts.in_capsule_data_size), 1850 spdk_json_decode_uint32, true 1851 }, 1852 { 1853 "max_io_size", offsetof(struct nvmf_rpc_create_transport_ctx, opts.max_io_size), 1854 spdk_json_decode_uint32, true 1855 }, 1856 { 1857 "io_unit_size", offsetof(struct nvmf_rpc_create_transport_ctx, opts.io_unit_size), 1858 spdk_json_decode_uint32, true 1859 }, 1860 { 1861 "max_aq_depth", offsetof(struct nvmf_rpc_create_transport_ctx, opts.max_aq_depth), 1862 spdk_json_decode_uint32, true 1863 }, 1864 { 1865 "num_shared_buffers", offsetof(struct nvmf_rpc_create_transport_ctx, opts.num_shared_buffers), 1866 spdk_json_decode_uint32, true 1867 }, 1868 { 1869 "buf_cache_size", offsetof(struct nvmf_rpc_create_transport_ctx, opts.buf_cache_size), 1870 spdk_json_decode_uint32, true 1871 }, 1872 { 1873 "dif_insert_or_strip", offsetof(struct nvmf_rpc_create_transport_ctx, opts.dif_insert_or_strip), 1874 spdk_json_decode_bool, true 1875 }, 1876 { 1877 "abort_timeout_sec", offsetof(struct nvmf_rpc_create_transport_ctx, opts.abort_timeout_sec), 1878 spdk_json_decode_uint32, true 1879 }, 1880 { 1881 "tgt_name", offsetof(struct nvmf_rpc_create_transport_ctx, tgt_name), 1882 spdk_json_decode_string, true 1883 }, 1884 }; 1885 1886 static void 1887 nvmf_rpc_create_transport_ctx_free(struct nvmf_rpc_create_transport_ctx *ctx) 1888 { 1889 free(ctx->trtype); 1890 free(ctx->tgt_name); 1891 free(ctx); 1892 } 1893 1894 static void 1895 nvmf_rpc_tgt_add_transport_done(void *cb_arg, int status) 1896 { 1897 struct nvmf_rpc_create_transport_ctx *ctx = cb_arg; 1898 struct spdk_jsonrpc_request *request; 1899 struct spdk_json_write_ctx *w; 1900 1901 request = ctx->request; 1902 nvmf_rpc_create_transport_ctx_free(ctx); 1903 1904 if (status) { 1905 SPDK_ERRLOG("Failed to add transport to tgt.(%d)\n", status); 1906 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1907 "Failed to add transport to tgt.(%d)", 1908 status); 1909 return; 1910 } 1911 1912 w = spdk_jsonrpc_begin_result(request); 1913 spdk_json_write_bool(w, true); 1914 spdk_jsonrpc_end_result(request, w); 1915 } 1916 1917 static void 1918 rpc_nvmf_create_transport(struct spdk_jsonrpc_request *request, 1919 const struct spdk_json_val *params) 1920 { 1921 struct nvmf_rpc_create_transport_ctx *ctx; 1922 enum spdk_nvme_transport_type trtype; 1923 struct spdk_nvmf_transport *transport; 1924 struct spdk_nvmf_tgt *tgt; 1925 1926 ctx = calloc(1, sizeof(*ctx)); 1927 if (!ctx) { 1928 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, "Out of memory"); 1929 return; 1930 } 1931 1932 /* Decode parameters the first time to get the transport type */ 1933 if (spdk_json_decode_object_relaxed(params, nvmf_rpc_create_transport_decoder, 1934 SPDK_COUNTOF(nvmf_rpc_create_transport_decoder), 1935 ctx)) { 1936 SPDK_ERRLOG("spdk_json_decode_object_relaxed failed\n"); 1937 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1938 nvmf_rpc_create_transport_ctx_free(ctx); 1939 return; 1940 } 1941 1942 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 1943 if (!tgt) { 1944 SPDK_ERRLOG("Unable to find a target object.\n"); 1945 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1946 "Unable to find a target."); 1947 nvmf_rpc_create_transport_ctx_free(ctx); 1948 return; 1949 } 1950 1951 if (spdk_nvme_transport_id_parse_trtype(&trtype, ctx->trtype)) { 1952 SPDK_ERRLOG("Invalid transport type '%s'\n", ctx->trtype); 1953 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1954 "Invalid transport type '%s'", ctx->trtype); 1955 nvmf_rpc_create_transport_ctx_free(ctx); 1956 return; 1957 } 1958 1959 /* Initialize all the transport options (based on transport type) and decode the 1960 * parameters again to update any options passed in rpc create transport call. 1961 */ 1962 if (!spdk_nvmf_transport_opts_init(ctx->trtype, &ctx->opts)) { 1963 /* This can happen if user specifies PCIE transport type which isn't valid for 1964 * NVMe-oF. 1965 */ 1966 SPDK_ERRLOG("Invalid transport type '%s'\n", ctx->trtype); 1967 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 1968 "Invalid transport type '%s'", ctx->trtype); 1969 nvmf_rpc_create_transport_ctx_free(ctx); 1970 return; 1971 } 1972 1973 if (spdk_json_decode_object_relaxed(params, nvmf_rpc_create_transport_decoder, 1974 SPDK_COUNTOF(nvmf_rpc_create_transport_decoder), 1975 ctx)) { 1976 SPDK_ERRLOG("spdk_json_decode_object_relaxed failed\n"); 1977 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 1978 nvmf_rpc_create_transport_ctx_free(ctx); 1979 return; 1980 } 1981 1982 if (spdk_nvmf_tgt_get_transport(tgt, ctx->trtype)) { 1983 SPDK_ERRLOG("Transport type '%s' already exists\n", ctx->trtype); 1984 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1985 "Transport type '%s' already exists", ctx->trtype); 1986 nvmf_rpc_create_transport_ctx_free(ctx); 1987 return; 1988 } 1989 1990 /* Transport can parse additional params themselves */ 1991 ctx->opts.transport_specific = params; 1992 1993 transport = spdk_nvmf_transport_create(ctx->trtype, &ctx->opts); 1994 1995 if (!transport) { 1996 SPDK_ERRLOG("Transport type '%s' create failed\n", ctx->trtype); 1997 spdk_jsonrpc_send_error_response_fmt(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 1998 "Transport type '%s' create failed", ctx->trtype); 1999 nvmf_rpc_create_transport_ctx_free(ctx); 2000 return; 2001 } 2002 2003 /* add transport to target */ 2004 ctx->request = request; 2005 spdk_nvmf_tgt_add_transport(tgt, transport, nvmf_rpc_tgt_add_transport_done, ctx); 2006 } 2007 SPDK_RPC_REGISTER("nvmf_create_transport", rpc_nvmf_create_transport, SPDK_RPC_RUNTIME) 2008 2009 static void 2010 dump_nvmf_transport(struct spdk_json_write_ctx *w, struct spdk_nvmf_transport *transport) 2011 { 2012 const struct spdk_nvmf_transport_opts *opts = spdk_nvmf_get_transport_opts(transport); 2013 2014 spdk_json_write_object_begin(w); 2015 2016 spdk_json_write_named_string(w, "trtype", spdk_nvmf_get_transport_name(transport)); 2017 spdk_json_write_named_uint32(w, "max_queue_depth", opts->max_queue_depth); 2018 spdk_json_write_named_uint32(w, "max_io_qpairs_per_ctrlr", opts->max_qpairs_per_ctrlr - 1); 2019 spdk_json_write_named_uint32(w, "in_capsule_data_size", opts->in_capsule_data_size); 2020 spdk_json_write_named_uint32(w, "max_io_size", opts->max_io_size); 2021 spdk_json_write_named_uint32(w, "io_unit_size", opts->io_unit_size); 2022 spdk_json_write_named_uint32(w, "max_aq_depth", opts->max_aq_depth); 2023 spdk_json_write_named_uint32(w, "num_shared_buffers", opts->num_shared_buffers); 2024 spdk_json_write_named_uint32(w, "buf_cache_size", opts->buf_cache_size); 2025 spdk_json_write_named_bool(w, "dif_insert_or_strip", opts->dif_insert_or_strip); 2026 2027 if (transport->ops->dump_opts) { 2028 transport->ops->dump_opts(transport, w); 2029 } 2030 2031 spdk_json_write_named_uint32(w, "abort_timeout_sec", opts->abort_timeout_sec); 2032 2033 spdk_json_write_object_end(w); 2034 } 2035 2036 struct rpc_get_transport { 2037 char *tgt_name; 2038 }; 2039 2040 static const struct spdk_json_object_decoder rpc_get_transport_decoders[] = { 2041 {"tgt_name", offsetof(struct rpc_get_transport, tgt_name), spdk_json_decode_string, true}, 2042 }; 2043 2044 static void 2045 rpc_nvmf_get_transports(struct spdk_jsonrpc_request *request, 2046 const struct spdk_json_val *params) 2047 { 2048 struct rpc_get_transport req = { 0 }; 2049 struct spdk_json_write_ctx *w; 2050 struct spdk_nvmf_transport *transport; 2051 struct spdk_nvmf_tgt *tgt; 2052 2053 if (params) { 2054 if (spdk_json_decode_object(params, rpc_get_transport_decoders, 2055 SPDK_COUNTOF(rpc_get_transport_decoders), 2056 &req)) { 2057 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 2058 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 2059 return; 2060 } 2061 } 2062 2063 tgt = spdk_nvmf_get_tgt(req.tgt_name); 2064 if (!tgt) { 2065 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 2066 "Unable to find a target."); 2067 free(req.tgt_name); 2068 return; 2069 } 2070 2071 w = spdk_jsonrpc_begin_result(request); 2072 spdk_json_write_array_begin(w); 2073 transport = spdk_nvmf_transport_get_first(tgt); 2074 while (transport) { 2075 dump_nvmf_transport(w, transport); 2076 transport = spdk_nvmf_transport_get_next(transport); 2077 } 2078 spdk_json_write_array_end(w); 2079 spdk_jsonrpc_end_result(request, w); 2080 free(req.tgt_name); 2081 } 2082 SPDK_RPC_REGISTER("nvmf_get_transports", rpc_nvmf_get_transports, SPDK_RPC_RUNTIME) 2083 SPDK_RPC_REGISTER_ALIAS_DEPRECATED(nvmf_get_transports, get_nvmf_transports) 2084 2085 struct rpc_nvmf_get_stats_ctx { 2086 char *tgt_name; 2087 struct spdk_nvmf_tgt *tgt; 2088 struct spdk_jsonrpc_request *request; 2089 struct spdk_json_write_ctx *w; 2090 }; 2091 2092 static const struct spdk_json_object_decoder rpc_get_stats_decoders[] = { 2093 {"tgt_name", offsetof(struct rpc_nvmf_get_stats_ctx, tgt_name), spdk_json_decode_string, true}, 2094 }; 2095 2096 static void 2097 free_get_stats_ctx(struct rpc_nvmf_get_stats_ctx *ctx) 2098 { 2099 free(ctx->tgt_name); 2100 free(ctx); 2101 } 2102 2103 static void 2104 rpc_nvmf_get_stats_done(struct spdk_io_channel_iter *i, int status) 2105 { 2106 struct rpc_nvmf_get_stats_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 2107 2108 spdk_json_write_array_end(ctx->w); 2109 spdk_json_write_object_end(ctx->w); 2110 spdk_jsonrpc_end_result(ctx->request, ctx->w); 2111 free_get_stats_ctx(ctx); 2112 } 2113 2114 static void 2115 write_nvmf_transport_stats(struct spdk_json_write_ctx *w, 2116 struct spdk_nvmf_transport_poll_group_stat *stat) 2117 { 2118 uint64_t i; 2119 2120 spdk_json_write_object_begin(w); 2121 spdk_json_write_named_string(w, "trtype", 2122 spdk_nvme_transport_id_trtype_str(stat->trtype)); 2123 switch (stat->trtype) { 2124 case SPDK_NVME_TRANSPORT_RDMA: 2125 spdk_json_write_named_uint64(w, "pending_data_buffer", stat->rdma.pending_data_buffer); 2126 spdk_json_write_named_array_begin(w, "devices"); 2127 for (i = 0; i < stat->rdma.num_devices; ++i) { 2128 spdk_json_write_object_begin(w); 2129 spdk_json_write_named_string(w, "name", stat->rdma.devices[i].name); 2130 spdk_json_write_named_uint64(w, "polls", stat->rdma.devices[i].polls); 2131 spdk_json_write_named_uint64(w, "completions", stat->rdma.devices[i].completions); 2132 spdk_json_write_named_uint64(w, "requests", 2133 stat->rdma.devices[i].requests); 2134 spdk_json_write_named_uint64(w, "request_latency", 2135 stat->rdma.devices[i].request_latency); 2136 spdk_json_write_named_uint64(w, "pending_free_request", 2137 stat->rdma.devices[i].pending_free_request); 2138 spdk_json_write_named_uint64(w, "pending_rdma_read", 2139 stat->rdma.devices[i].pending_rdma_read); 2140 spdk_json_write_named_uint64(w, "pending_rdma_write", 2141 stat->rdma.devices[i].pending_rdma_write); 2142 spdk_json_write_object_end(w); 2143 } 2144 spdk_json_write_array_end(w); 2145 break; 2146 default: 2147 break; 2148 } 2149 spdk_json_write_object_end(w); 2150 } 2151 2152 static void 2153 _rpc_nvmf_get_stats(struct spdk_io_channel_iter *i) 2154 { 2155 struct rpc_nvmf_get_stats_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 2156 struct spdk_nvmf_transport *transport; 2157 struct spdk_nvmf_poll_group_stat stat; 2158 struct spdk_nvmf_transport_poll_group_stat *trstat; 2159 int rc; 2160 2161 if (0 == spdk_nvmf_poll_group_get_stat(ctx->tgt, &stat)) { 2162 spdk_json_write_object_begin(ctx->w); 2163 spdk_json_write_named_string(ctx->w, "name", spdk_thread_get_name(spdk_get_thread())); 2164 spdk_json_write_named_uint32(ctx->w, "admin_qpairs", stat.admin_qpairs); 2165 spdk_json_write_named_uint32(ctx->w, "io_qpairs", stat.io_qpairs); 2166 spdk_json_write_named_uint64(ctx->w, "pending_bdev_io", stat.pending_bdev_io); 2167 2168 spdk_json_write_named_array_begin(ctx->w, "transports"); 2169 transport = spdk_nvmf_transport_get_first(ctx->tgt); 2170 while (transport) { 2171 rc = spdk_nvmf_transport_poll_group_get_stat(ctx->tgt, transport, &trstat); 2172 if (0 == rc) { 2173 write_nvmf_transport_stats(ctx->w, trstat); 2174 spdk_nvmf_transport_poll_group_free_stat(transport, trstat); 2175 } else if (-ENOTSUP != rc) { 2176 SPDK_ERRLOG("Failed to get poll group statistics for transport %s, errno %d\n", 2177 spdk_nvme_transport_id_trtype_str(spdk_nvmf_get_transport_type(transport)), 2178 rc); 2179 } 2180 transport = spdk_nvmf_transport_get_next(transport); 2181 } 2182 spdk_json_write_array_end(ctx->w); 2183 spdk_json_write_object_end(ctx->w); 2184 } 2185 2186 spdk_for_each_channel_continue(i, 0); 2187 } 2188 2189 2190 static void 2191 rpc_nvmf_get_stats(struct spdk_jsonrpc_request *request, 2192 const struct spdk_json_val *params) 2193 { 2194 struct rpc_nvmf_get_stats_ctx *ctx; 2195 2196 ctx = calloc(1, sizeof(*ctx)); 2197 if (!ctx) { 2198 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 2199 "Memory allocation error"); 2200 return; 2201 } 2202 ctx->request = request; 2203 2204 if (params) { 2205 if (spdk_json_decode_object(params, rpc_get_stats_decoders, 2206 SPDK_COUNTOF(rpc_get_stats_decoders), 2207 ctx)) { 2208 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 2209 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, "Invalid parameters"); 2210 free_get_stats_ctx(ctx); 2211 return; 2212 } 2213 } 2214 2215 ctx->tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 2216 if (!ctx->tgt) { 2217 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 2218 "Unable to find a target."); 2219 free_get_stats_ctx(ctx); 2220 return; 2221 } 2222 2223 ctx->w = spdk_jsonrpc_begin_result(ctx->request); 2224 spdk_json_write_object_begin(ctx->w); 2225 spdk_json_write_named_uint64(ctx->w, "tick_rate", spdk_get_ticks_hz()); 2226 spdk_json_write_named_array_begin(ctx->w, "poll_groups"); 2227 2228 spdk_for_each_channel(ctx->tgt, 2229 _rpc_nvmf_get_stats, 2230 ctx, 2231 rpc_nvmf_get_stats_done); 2232 } 2233 2234 SPDK_RPC_REGISTER("nvmf_get_stats", rpc_nvmf_get_stats, SPDK_RPC_RUNTIME) 2235 2236 static void 2237 dump_nvmf_ctrlr(struct spdk_json_write_ctx *w, struct spdk_nvmf_ctrlr *ctrlr) 2238 { 2239 char uuid_str[SPDK_UUID_STRING_LEN] = {}; 2240 uint32_t count; 2241 2242 spdk_json_write_object_begin(w); 2243 2244 spdk_json_write_named_uint32(w, "cntlid", ctrlr->cntlid); 2245 2246 spdk_json_write_named_string(w, "hostnqn", ctrlr->hostnqn); 2247 2248 spdk_uuid_fmt_lower(uuid_str, sizeof(uuid_str), &ctrlr->hostid); 2249 spdk_json_write_named_string(w, "hostid", uuid_str); 2250 2251 count = spdk_bit_array_count_set(ctrlr->qpair_mask); 2252 spdk_json_write_named_uint32(w, "num_io_qpairs", count); 2253 2254 spdk_json_write_object_end(w); 2255 } 2256 2257 static const char * 2258 nvmf_qpair_state_str(enum spdk_nvmf_qpair_state state) 2259 { 2260 switch (state) { 2261 case SPDK_NVMF_QPAIR_UNINITIALIZED: 2262 return "uninitialized"; 2263 case SPDK_NVMF_QPAIR_ACTIVE: 2264 return "active"; 2265 case SPDK_NVMF_QPAIR_DEACTIVATING: 2266 return "deactivating"; 2267 case SPDK_NVMF_QPAIR_ERROR: 2268 return "error"; 2269 default: 2270 return NULL; 2271 } 2272 } 2273 2274 static void 2275 dump_nvmf_qpair(struct spdk_json_write_ctx *w, struct spdk_nvmf_qpair *qpair) 2276 { 2277 const struct spdk_nvme_transport_id *trid = qpair->trid; 2278 const char *adrfam; 2279 2280 spdk_json_write_object_begin(w); 2281 2282 spdk_json_write_named_uint32(w, "cntlid", qpair->ctrlr->cntlid); 2283 spdk_json_write_named_uint32(w, "qid", qpair->qid); 2284 spdk_json_write_named_string(w, "state", nvmf_qpair_state_str(qpair->state)); 2285 2286 spdk_json_write_named_object_begin(w, "listen_address"); 2287 adrfam = spdk_nvme_transport_id_adrfam_str(trid->adrfam); 2288 if (adrfam == NULL) { 2289 adrfam = "unknown"; 2290 } 2291 spdk_json_write_named_string(w, "trtype", trid->trstring); 2292 spdk_json_write_named_string(w, "adrfam", adrfam); 2293 spdk_json_write_named_string(w, "traddr", trid->traddr); 2294 spdk_json_write_named_string(w, "trsvcid", trid->trsvcid); 2295 spdk_json_write_object_end(w); 2296 2297 spdk_json_write_object_end(w); 2298 } 2299 2300 static const char * 2301 nvme_ana_state_str(enum spdk_nvme_ana_state ana_state) 2302 { 2303 switch (ana_state) { 2304 case SPDK_NVME_ANA_OPTIMIZED_STATE: 2305 return "optimized"; 2306 case SPDK_NVME_ANA_NON_OPTIMIZED_STATE: 2307 return "non_optimized"; 2308 case SPDK_NVME_ANA_INACCESSIBLE_STATE: 2309 return "inaccessible"; 2310 case SPDK_NVME_ANA_PERSISTENT_LOSS_STATE: 2311 return "persistent_loss"; 2312 case SPDK_NVME_ANA_CHANGE_STATE: 2313 return "change"; 2314 default: 2315 return NULL; 2316 } 2317 } 2318 2319 static void 2320 dump_nvmf_subsystem_listener(struct spdk_json_write_ctx *w, 2321 struct spdk_nvmf_subsystem_listener *listener) 2322 { 2323 const struct spdk_nvme_transport_id *trid = listener->trid; 2324 const char *adrfam; 2325 2326 spdk_json_write_object_begin(w); 2327 2328 spdk_json_write_named_object_begin(w, "address"); 2329 adrfam = spdk_nvme_transport_id_adrfam_str(trid->adrfam); 2330 if (adrfam == NULL) { 2331 adrfam = "unknown"; 2332 } 2333 spdk_json_write_named_string(w, "trtype", trid->trstring); 2334 spdk_json_write_named_string(w, "adrfam", adrfam); 2335 spdk_json_write_named_string(w, "traddr", trid->traddr); 2336 spdk_json_write_named_string(w, "trsvcid", trid->trsvcid); 2337 spdk_json_write_object_end(w); 2338 2339 spdk_json_write_named_string(w, "ana_state", 2340 nvme_ana_state_str(listener->ana_state)); 2341 2342 spdk_json_write_object_end(w); 2343 } 2344 2345 struct rpc_subsystem_query_ctx { 2346 char *nqn; 2347 char *tgt_name; 2348 struct spdk_nvmf_subsystem *subsystem; 2349 struct spdk_jsonrpc_request *request; 2350 struct spdk_json_write_ctx *w; 2351 }; 2352 2353 static const struct spdk_json_object_decoder rpc_subsystem_query_decoders[] = { 2354 {"nqn", offsetof(struct rpc_subsystem_query_ctx, nqn), spdk_json_decode_string}, 2355 {"tgt_name", offsetof(struct rpc_subsystem_query_ctx, tgt_name), spdk_json_decode_string, true}, 2356 }; 2357 2358 static void 2359 free_rpc_subsystem_query_ctx(struct rpc_subsystem_query_ctx *ctx) 2360 { 2361 free(ctx->nqn); 2362 free(ctx->tgt_name); 2363 free(ctx); 2364 } 2365 2366 static void 2367 rpc_nvmf_get_controllers_paused(struct spdk_nvmf_subsystem *subsystem, 2368 void *cb_arg, int status) 2369 { 2370 struct rpc_subsystem_query_ctx *ctx = cb_arg; 2371 struct spdk_json_write_ctx *w; 2372 struct spdk_nvmf_ctrlr *ctrlr; 2373 2374 w = spdk_jsonrpc_begin_result(ctx->request); 2375 2376 spdk_json_write_array_begin(w); 2377 TAILQ_FOREACH(ctrlr, &ctx->subsystem->ctrlrs, link) { 2378 dump_nvmf_ctrlr(w, ctrlr); 2379 } 2380 spdk_json_write_array_end(w); 2381 2382 spdk_jsonrpc_end_result(ctx->request, w); 2383 2384 if (spdk_nvmf_subsystem_resume(ctx->subsystem, NULL, NULL)) { 2385 SPDK_ERRLOG("Resuming subsystem with NQN %s failed\n", ctx->nqn); 2386 /* FIXME: RPC should fail if resuming the subsystem failed. */ 2387 } 2388 2389 free_rpc_subsystem_query_ctx(ctx); 2390 } 2391 2392 static void 2393 rpc_nvmf_get_qpairs_done(struct spdk_io_channel_iter *i, int status) 2394 { 2395 struct rpc_subsystem_query_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 2396 2397 spdk_json_write_array_end(ctx->w); 2398 spdk_jsonrpc_end_result(ctx->request, ctx->w); 2399 2400 if (spdk_nvmf_subsystem_resume(ctx->subsystem, NULL, NULL)) { 2401 SPDK_ERRLOG("Resuming subsystem with NQN %s failed\n", ctx->nqn); 2402 /* FIXME: RPC should fail if resuming the subsystem failed. */ 2403 } 2404 2405 free_rpc_subsystem_query_ctx(ctx); 2406 } 2407 2408 static void 2409 rpc_nvmf_get_qpairs(struct spdk_io_channel_iter *i) 2410 { 2411 struct rpc_subsystem_query_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 2412 struct spdk_io_channel *ch; 2413 struct spdk_nvmf_poll_group *group; 2414 struct spdk_nvmf_qpair *qpair; 2415 2416 ch = spdk_get_io_channel(ctx->subsystem->tgt); 2417 group = spdk_io_channel_get_ctx(ch); 2418 2419 TAILQ_FOREACH(qpair, &group->qpairs, link) { 2420 if (qpair->ctrlr->subsys == ctx->subsystem) { 2421 dump_nvmf_qpair(ctx->w, qpair); 2422 } 2423 } 2424 2425 spdk_for_each_channel_continue(i, 0); 2426 } 2427 2428 static void 2429 rpc_nvmf_get_qpairs_paused(struct spdk_nvmf_subsystem *subsystem, 2430 void *cb_arg, int status) 2431 { 2432 struct rpc_subsystem_query_ctx *ctx = cb_arg; 2433 2434 ctx->w = spdk_jsonrpc_begin_result(ctx->request); 2435 2436 spdk_json_write_array_begin(ctx->w); 2437 2438 spdk_for_each_channel(ctx->subsystem->tgt, 2439 rpc_nvmf_get_qpairs, 2440 ctx, 2441 rpc_nvmf_get_qpairs_done); 2442 } 2443 2444 static void 2445 rpc_nvmf_get_listeners_paused(struct spdk_nvmf_subsystem *subsystem, 2446 void *cb_arg, int status) 2447 { 2448 struct rpc_subsystem_query_ctx *ctx = cb_arg; 2449 struct spdk_json_write_ctx *w; 2450 struct spdk_nvmf_subsystem_listener *listener; 2451 2452 w = spdk_jsonrpc_begin_result(ctx->request); 2453 2454 spdk_json_write_array_begin(w); 2455 2456 for (listener = spdk_nvmf_subsystem_get_first_listener(ctx->subsystem); 2457 listener != NULL; 2458 listener = spdk_nvmf_subsystem_get_next_listener(ctx->subsystem, listener)) { 2459 dump_nvmf_subsystem_listener(w, listener); 2460 } 2461 spdk_json_write_array_end(w); 2462 2463 spdk_jsonrpc_end_result(ctx->request, w); 2464 2465 if (spdk_nvmf_subsystem_resume(ctx->subsystem, NULL, NULL)) { 2466 SPDK_ERRLOG("Resuming subsystem with NQN %s failed\n", ctx->nqn); 2467 /* FIXME: RPC should fail if resuming the subsystem failed. */ 2468 } 2469 2470 free_rpc_subsystem_query_ctx(ctx); 2471 } 2472 2473 static void 2474 _rpc_nvmf_subsystem_query(struct spdk_jsonrpc_request *request, 2475 const struct spdk_json_val *params, 2476 spdk_nvmf_subsystem_state_change_done cb_fn) 2477 { 2478 struct rpc_subsystem_query_ctx *ctx; 2479 struct spdk_nvmf_subsystem *subsystem; 2480 struct spdk_nvmf_tgt *tgt; 2481 2482 ctx = calloc(1, sizeof(*ctx)); 2483 if (!ctx) { 2484 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 2485 "Out of memory"); 2486 return; 2487 } 2488 2489 ctx->request = request; 2490 2491 if (spdk_json_decode_object(params, rpc_subsystem_query_decoders, 2492 SPDK_COUNTOF(rpc_subsystem_query_decoders), 2493 ctx)) { 2494 SPDK_ERRLOG("spdk_json_decode_object failed\n"); 2495 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 2496 "Invalid parameters"); 2497 free_rpc_subsystem_query_ctx(ctx); 2498 return; 2499 } 2500 2501 tgt = spdk_nvmf_get_tgt(ctx->tgt_name); 2502 if (!tgt) { 2503 SPDK_ERRLOG("Unable to find a target object.\n"); 2504 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 2505 "Unable to find a target"); 2506 free_rpc_subsystem_query_ctx(ctx); 2507 return; 2508 } 2509 2510 subsystem = spdk_nvmf_tgt_find_subsystem(tgt, ctx->nqn); 2511 if (!subsystem) { 2512 SPDK_ERRLOG("Unable to find subsystem with NQN %s\n", ctx->nqn); 2513 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INVALID_PARAMS, 2514 "Invalid parameters"); 2515 free_rpc_subsystem_query_ctx(ctx); 2516 return; 2517 } 2518 2519 ctx->subsystem = subsystem; 2520 2521 if (spdk_nvmf_subsystem_pause(subsystem, cb_fn, ctx)) { 2522 spdk_jsonrpc_send_error_response(request, SPDK_JSONRPC_ERROR_INTERNAL_ERROR, 2523 "Internal error"); 2524 free_rpc_subsystem_query_ctx(ctx); 2525 return; 2526 } 2527 } 2528 2529 static void 2530 rpc_nvmf_subsystem_get_controllers(struct spdk_jsonrpc_request *request, 2531 const struct spdk_json_val *params) 2532 { 2533 _rpc_nvmf_subsystem_query(request, params, rpc_nvmf_get_controllers_paused); 2534 } 2535 SPDK_RPC_REGISTER("nvmf_subsystem_get_controllers", rpc_nvmf_subsystem_get_controllers, 2536 SPDK_RPC_RUNTIME); 2537 2538 static void 2539 rpc_nvmf_subsystem_get_qpairs(struct spdk_jsonrpc_request *request, 2540 const struct spdk_json_val *params) 2541 { 2542 _rpc_nvmf_subsystem_query(request, params, rpc_nvmf_get_qpairs_paused); 2543 } 2544 SPDK_RPC_REGISTER("nvmf_subsystem_get_qpairs", rpc_nvmf_subsystem_get_qpairs, SPDK_RPC_RUNTIME); 2545 2546 static void 2547 rpc_nvmf_subsystem_get_listeners(struct spdk_jsonrpc_request *request, 2548 const struct spdk_json_val *params) 2549 { 2550 _rpc_nvmf_subsystem_query(request, params, rpc_nvmf_get_listeners_paused); 2551 } 2552 SPDK_RPC_REGISTER("nvmf_subsystem_get_listeners", rpc_nvmf_subsystem_get_listeners, 2553 SPDK_RPC_RUNTIME); 2554