1 /* SPDX-License-Identifier: BSD-3-Clause 2 * Copyright (C) 2016 Intel Corporation. All rights reserved. 3 * Copyright (c) 2018-2019, 2021 Mellanox Technologies LTD. All rights reserved. 4 * Copyright (c) 2021, 2023 NVIDIA CORPORATION & AFFILIATES. All rights reserved. 5 */ 6 7 #include "spdk/stdinc.h" 8 9 #include "spdk/bdev.h" 10 #include "spdk/bit_array.h" 11 #include "spdk/thread.h" 12 #include "spdk/nvmf.h" 13 #include "spdk/endian.h" 14 #include "spdk/string.h" 15 #include "spdk/log.h" 16 #include "spdk_internal/usdt.h" 17 18 #include "nvmf_internal.h" 19 #include "transport.h" 20 21 SPDK_LOG_REGISTER_COMPONENT(nvmf) 22 23 #define SPDK_NVMF_DEFAULT_MAX_SUBSYSTEMS 1024 24 25 static TAILQ_HEAD(, spdk_nvmf_tgt) g_nvmf_tgts = TAILQ_HEAD_INITIALIZER(g_nvmf_tgts); 26 27 typedef void (*nvmf_qpair_disconnect_cpl)(void *ctx, int status); 28 29 /* supplied to a single call to nvmf_qpair_disconnect */ 30 struct nvmf_qpair_disconnect_ctx { 31 struct spdk_nvmf_qpair *qpair; 32 struct spdk_nvmf_ctrlr *ctrlr; 33 nvmf_qpair_disconnect_cb cb_fn; 34 struct spdk_thread *thread; 35 void *ctx; 36 uint16_t qid; 37 }; 38 39 /* 40 * There are several times when we need to iterate through the list of all qpairs and selectively delete them. 41 * In order to do this sequentially without overlap, we must provide a context to recover the next qpair from 42 * to enable calling nvmf_qpair_disconnect on the next desired qpair. 43 */ 44 struct nvmf_qpair_disconnect_many_ctx { 45 struct spdk_nvmf_subsystem *subsystem; 46 struct spdk_nvmf_poll_group *group; 47 spdk_nvmf_poll_group_mod_done cpl_fn; 48 void *cpl_ctx; 49 }; 50 51 static void 52 nvmf_qpair_set_state(struct spdk_nvmf_qpair *qpair, 53 enum spdk_nvmf_qpair_state state) 54 { 55 assert(qpair != NULL); 56 assert(qpair->group->thread == spdk_get_thread()); 57 58 qpair->state = state; 59 } 60 61 static int 62 nvmf_poll_group_poll(void *ctx) 63 { 64 struct spdk_nvmf_poll_group *group = ctx; 65 int rc; 66 int count = 0; 67 struct spdk_nvmf_transport_poll_group *tgroup; 68 69 TAILQ_FOREACH(tgroup, &group->tgroups, link) { 70 rc = nvmf_transport_poll_group_poll(tgroup); 71 if (rc < 0) { 72 return SPDK_POLLER_BUSY; 73 } 74 count += rc; 75 } 76 77 return count > 0 ? SPDK_POLLER_BUSY : SPDK_POLLER_IDLE; 78 } 79 80 /* 81 * Reset and clean up the poll group (I/O channel code will actually free the 82 * group). 83 */ 84 static void 85 nvmf_tgt_cleanup_poll_group(struct spdk_nvmf_poll_group *group) 86 { 87 struct spdk_nvmf_transport_poll_group *tgroup, *tmp; 88 struct spdk_nvmf_subsystem_poll_group *sgroup; 89 uint32_t sid, nsid; 90 91 TAILQ_FOREACH_SAFE(tgroup, &group->tgroups, link, tmp) { 92 TAILQ_REMOVE(&group->tgroups, tgroup, link); 93 nvmf_transport_poll_group_destroy(tgroup); 94 } 95 96 for (sid = 0; sid < group->num_sgroups; sid++) { 97 sgroup = &group->sgroups[sid]; 98 99 assert(sgroup != NULL); 100 101 for (nsid = 0; nsid < sgroup->num_ns; nsid++) { 102 if (sgroup->ns_info[nsid].channel) { 103 spdk_put_io_channel(sgroup->ns_info[nsid].channel); 104 sgroup->ns_info[nsid].channel = NULL; 105 } 106 } 107 108 free(sgroup->ns_info); 109 } 110 111 free(group->sgroups); 112 113 spdk_poller_unregister(&group->poller); 114 115 if (group->destroy_cb_fn) { 116 group->destroy_cb_fn(group->destroy_cb_arg, 0); 117 } 118 } 119 120 /* 121 * Callback to unregister a poll group from the target, and clean up its state. 122 */ 123 static void 124 nvmf_tgt_destroy_poll_group(void *io_device, void *ctx_buf) 125 { 126 struct spdk_nvmf_tgt *tgt = io_device; 127 struct spdk_nvmf_poll_group *group = ctx_buf; 128 129 SPDK_DTRACE_PROBE1_TICKS(nvmf_destroy_poll_group, spdk_thread_get_id(group->thread)); 130 131 pthread_mutex_lock(&tgt->mutex); 132 TAILQ_REMOVE(&tgt->poll_groups, group, link); 133 tgt->num_poll_groups--; 134 pthread_mutex_unlock(&tgt->mutex); 135 136 assert(!(tgt->state == NVMF_TGT_PAUSING || tgt->state == NVMF_TGT_RESUMING)); 137 nvmf_tgt_cleanup_poll_group(group); 138 } 139 140 static int 141 nvmf_poll_group_add_transport(struct spdk_nvmf_poll_group *group, 142 struct spdk_nvmf_transport *transport) 143 { 144 struct spdk_nvmf_transport_poll_group *tgroup; 145 146 TAILQ_FOREACH(tgroup, &group->tgroups, link) { 147 if (tgroup->transport == transport) { 148 /* Transport already in the poll group */ 149 return 0; 150 } 151 } 152 153 tgroup = nvmf_transport_poll_group_create(transport, group); 154 if (!tgroup) { 155 SPDK_ERRLOG("Unable to create poll group for transport\n"); 156 return -1; 157 } 158 SPDK_DTRACE_PROBE2_TICKS(nvmf_transport_poll_group_create, transport, 159 spdk_thread_get_id(group->thread)); 160 161 tgroup->group = group; 162 TAILQ_INSERT_TAIL(&group->tgroups, tgroup, link); 163 164 return 0; 165 } 166 167 static int 168 nvmf_tgt_create_poll_group(void *io_device, void *ctx_buf) 169 { 170 struct spdk_nvmf_tgt *tgt = io_device; 171 struct spdk_nvmf_poll_group *group = ctx_buf; 172 struct spdk_nvmf_transport *transport; 173 struct spdk_nvmf_subsystem *subsystem; 174 struct spdk_thread *thread = spdk_get_thread(); 175 int rc; 176 177 group->tgt = tgt; 178 TAILQ_INIT(&group->tgroups); 179 TAILQ_INIT(&group->qpairs); 180 group->thread = thread; 181 pthread_mutex_init(&group->mutex, NULL); 182 183 group->poller = SPDK_POLLER_REGISTER(nvmf_poll_group_poll, group, 0); 184 185 SPDK_DTRACE_PROBE1_TICKS(nvmf_create_poll_group, spdk_thread_get_id(thread)); 186 187 TAILQ_FOREACH(transport, &tgt->transports, link) { 188 rc = nvmf_poll_group_add_transport(group, transport); 189 if (rc != 0) { 190 nvmf_tgt_cleanup_poll_group(group); 191 return rc; 192 } 193 } 194 195 group->num_sgroups = tgt->max_subsystems; 196 group->sgroups = calloc(tgt->max_subsystems, sizeof(struct spdk_nvmf_subsystem_poll_group)); 197 if (!group->sgroups) { 198 nvmf_tgt_cleanup_poll_group(group); 199 return -ENOMEM; 200 } 201 202 for (subsystem = spdk_nvmf_subsystem_get_first(tgt); 203 subsystem != NULL; 204 subsystem = spdk_nvmf_subsystem_get_next(subsystem)) { 205 if (nvmf_poll_group_add_subsystem(group, subsystem, NULL, NULL) != 0) { 206 nvmf_tgt_cleanup_poll_group(group); 207 return -1; 208 } 209 } 210 211 pthread_mutex_lock(&tgt->mutex); 212 tgt->num_poll_groups++; 213 TAILQ_INSERT_TAIL(&tgt->poll_groups, group, link); 214 pthread_mutex_unlock(&tgt->mutex); 215 216 return 0; 217 } 218 219 static void 220 _nvmf_tgt_disconnect_qpairs(void *ctx) 221 { 222 struct spdk_nvmf_qpair *qpair, *qpair_tmp; 223 struct nvmf_qpair_disconnect_many_ctx *qpair_ctx = ctx; 224 struct spdk_nvmf_poll_group *group = qpair_ctx->group; 225 struct spdk_io_channel *ch; 226 int rc; 227 228 TAILQ_FOREACH_SAFE(qpair, &group->qpairs, link, qpair_tmp) { 229 rc = spdk_nvmf_qpair_disconnect(qpair, NULL, NULL); 230 if (rc && rc != -EINPROGRESS) { 231 break; 232 } 233 } 234 235 if (TAILQ_EMPTY(&group->qpairs)) { 236 /* When the refcount from the channels reaches 0, nvmf_tgt_destroy_poll_group will be called. */ 237 ch = spdk_io_channel_from_ctx(group); 238 spdk_put_io_channel(ch); 239 free(qpair_ctx); 240 return; 241 } 242 243 /* Some qpairs are in process of being disconnected. Send a message and try to remove them again */ 244 spdk_thread_send_msg(spdk_get_thread(), _nvmf_tgt_disconnect_qpairs, ctx); 245 } 246 247 static void 248 nvmf_tgt_destroy_poll_group_qpairs(struct spdk_nvmf_poll_group *group) 249 { 250 struct nvmf_qpair_disconnect_many_ctx *ctx; 251 252 SPDK_DTRACE_PROBE1_TICKS(nvmf_destroy_poll_group_qpairs, spdk_thread_get_id(group->thread)); 253 254 ctx = calloc(1, sizeof(struct nvmf_qpair_disconnect_many_ctx)); 255 if (!ctx) { 256 SPDK_ERRLOG("Failed to allocate memory for destroy poll group ctx\n"); 257 return; 258 } 259 260 ctx->group = group; 261 _nvmf_tgt_disconnect_qpairs(ctx); 262 } 263 264 struct spdk_nvmf_tgt * 265 spdk_nvmf_tgt_create(struct spdk_nvmf_target_opts *opts) 266 { 267 struct spdk_nvmf_tgt *tgt, *tmp_tgt; 268 269 if (strnlen(opts->name, NVMF_TGT_NAME_MAX_LENGTH) == NVMF_TGT_NAME_MAX_LENGTH) { 270 SPDK_ERRLOG("Provided target name exceeds the max length of %u.\n", NVMF_TGT_NAME_MAX_LENGTH); 271 return NULL; 272 } 273 274 TAILQ_FOREACH(tmp_tgt, &g_nvmf_tgts, link) { 275 if (!strncmp(opts->name, tmp_tgt->name, NVMF_TGT_NAME_MAX_LENGTH)) { 276 SPDK_ERRLOG("Provided target name must be unique.\n"); 277 return NULL; 278 } 279 } 280 281 tgt = calloc(1, sizeof(*tgt)); 282 if (!tgt) { 283 return NULL; 284 } 285 286 snprintf(tgt->name, NVMF_TGT_NAME_MAX_LENGTH, "%s", opts->name); 287 288 if (!opts || !opts->max_subsystems) { 289 tgt->max_subsystems = SPDK_NVMF_DEFAULT_MAX_SUBSYSTEMS; 290 } else { 291 tgt->max_subsystems = opts->max_subsystems; 292 } 293 294 if (!opts) { 295 tgt->crdt[0] = 0; 296 tgt->crdt[1] = 0; 297 tgt->crdt[2] = 0; 298 } else { 299 tgt->crdt[0] = opts->crdt[0]; 300 tgt->crdt[1] = opts->crdt[1]; 301 tgt->crdt[2] = opts->crdt[2]; 302 } 303 304 if (!opts) { 305 tgt->discovery_filter = SPDK_NVMF_TGT_DISCOVERY_MATCH_ANY; 306 } else { 307 tgt->discovery_filter = opts->discovery_filter; 308 } 309 310 tgt->discovery_genctr = 0; 311 TAILQ_INIT(&tgt->transports); 312 TAILQ_INIT(&tgt->poll_groups); 313 tgt->num_poll_groups = 0; 314 315 tgt->subsystem_ids = spdk_bit_array_create(tgt->max_subsystems); 316 if (tgt->subsystem_ids == NULL) { 317 free(tgt); 318 return NULL; 319 } 320 321 RB_INIT(&tgt->subsystems); 322 323 pthread_mutex_init(&tgt->mutex, NULL); 324 325 spdk_io_device_register(tgt, 326 nvmf_tgt_create_poll_group, 327 nvmf_tgt_destroy_poll_group, 328 sizeof(struct spdk_nvmf_poll_group), 329 tgt->name); 330 331 tgt->state = NVMF_TGT_RUNNING; 332 333 TAILQ_INSERT_HEAD(&g_nvmf_tgts, tgt, link); 334 335 return tgt; 336 } 337 338 static void 339 _nvmf_tgt_destroy_next_transport(void *ctx) 340 { 341 struct spdk_nvmf_tgt *tgt = ctx; 342 struct spdk_nvmf_transport *transport; 343 344 if (!TAILQ_EMPTY(&tgt->transports)) { 345 transport = TAILQ_FIRST(&tgt->transports); 346 TAILQ_REMOVE(&tgt->transports, transport, link); 347 spdk_nvmf_transport_destroy(transport, _nvmf_tgt_destroy_next_transport, tgt); 348 } else { 349 spdk_nvmf_tgt_destroy_done_fn *destroy_cb_fn = tgt->destroy_cb_fn; 350 void *destroy_cb_arg = tgt->destroy_cb_arg; 351 352 pthread_mutex_destroy(&tgt->mutex); 353 free(tgt); 354 355 if (destroy_cb_fn) { 356 destroy_cb_fn(destroy_cb_arg, 0); 357 } 358 } 359 } 360 361 static void 362 nvmf_tgt_destroy_cb(void *io_device) 363 { 364 struct spdk_nvmf_tgt *tgt = io_device; 365 struct spdk_nvmf_subsystem *subsystem, *subsystem_next; 366 int rc; 367 368 /* We will be freeing subsystems in this loop, so we always need to get the next one 369 * ahead of time, since we can't call get_next() on a subsystem that's been freed. 370 */ 371 for (subsystem = spdk_nvmf_subsystem_get_first(tgt), 372 subsystem_next = spdk_nvmf_subsystem_get_next(subsystem); 373 subsystem != NULL; 374 subsystem = subsystem_next, 375 subsystem_next = spdk_nvmf_subsystem_get_next(subsystem_next)) { 376 nvmf_subsystem_remove_all_listeners(subsystem, true); 377 378 rc = spdk_nvmf_subsystem_destroy(subsystem, nvmf_tgt_destroy_cb, tgt); 379 if (rc) { 380 if (rc == -EINPROGRESS) { 381 /* If rc is -EINPROGRESS, nvmf_tgt_destroy_cb will be called again when subsystem #i 382 * is destroyed, nvmf_tgt_destroy_cb will continue to destroy other subsystems if any */ 383 return; 384 } else { 385 SPDK_ERRLOG("Failed to destroy subsystem %s, rc %d\n", subsystem->subnqn, rc); 386 } 387 } 388 } 389 spdk_bit_array_free(&tgt->subsystem_ids); 390 _nvmf_tgt_destroy_next_transport(tgt); 391 } 392 393 void 394 spdk_nvmf_tgt_destroy(struct spdk_nvmf_tgt *tgt, 395 spdk_nvmf_tgt_destroy_done_fn cb_fn, 396 void *cb_arg) 397 { 398 assert(!(tgt->state == NVMF_TGT_PAUSING || tgt->state == NVMF_TGT_RESUMING)); 399 400 tgt->destroy_cb_fn = cb_fn; 401 tgt->destroy_cb_arg = cb_arg; 402 403 TAILQ_REMOVE(&g_nvmf_tgts, tgt, link); 404 405 spdk_io_device_unregister(tgt, nvmf_tgt_destroy_cb); 406 } 407 408 const char * 409 spdk_nvmf_tgt_get_name(struct spdk_nvmf_tgt *tgt) 410 { 411 return tgt->name; 412 } 413 414 struct spdk_nvmf_tgt * 415 spdk_nvmf_get_tgt(const char *name) 416 { 417 struct spdk_nvmf_tgt *tgt; 418 uint32_t num_targets = 0; 419 420 TAILQ_FOREACH(tgt, &g_nvmf_tgts, link) { 421 if (name) { 422 if (!strncmp(tgt->name, name, NVMF_TGT_NAME_MAX_LENGTH)) { 423 return tgt; 424 } 425 } 426 num_targets++; 427 } 428 429 /* 430 * special case. If there is only one target and 431 * no name was specified, return the only available 432 * target. If there is more than one target, name must 433 * be specified. 434 */ 435 if (!name && num_targets == 1) { 436 return TAILQ_FIRST(&g_nvmf_tgts); 437 } 438 439 return NULL; 440 } 441 442 struct spdk_nvmf_tgt * 443 spdk_nvmf_get_first_tgt(void) 444 { 445 return TAILQ_FIRST(&g_nvmf_tgts); 446 } 447 448 struct spdk_nvmf_tgt * 449 spdk_nvmf_get_next_tgt(struct spdk_nvmf_tgt *prev) 450 { 451 return TAILQ_NEXT(prev, link); 452 } 453 454 static void 455 nvmf_write_subsystem_config_json(struct spdk_json_write_ctx *w, 456 struct spdk_nvmf_subsystem *subsystem) 457 { 458 struct spdk_nvmf_host *host; 459 struct spdk_nvmf_subsystem_listener *listener; 460 const struct spdk_nvme_transport_id *trid; 461 struct spdk_nvmf_ns *ns; 462 struct spdk_nvmf_ns_opts ns_opts; 463 uint32_t max_namespaces; 464 char uuid_str[SPDK_UUID_STRING_LEN]; 465 466 if (spdk_nvmf_subsystem_get_type(subsystem) != SPDK_NVMF_SUBTYPE_NVME) { 467 return; 468 } 469 470 /* { */ 471 spdk_json_write_object_begin(w); 472 spdk_json_write_named_string(w, "method", "nvmf_create_subsystem"); 473 474 /* "params" : { */ 475 spdk_json_write_named_object_begin(w, "params"); 476 spdk_json_write_named_string(w, "nqn", spdk_nvmf_subsystem_get_nqn(subsystem)); 477 spdk_json_write_named_bool(w, "allow_any_host", spdk_nvmf_subsystem_get_allow_any_host(subsystem)); 478 spdk_json_write_named_string(w, "serial_number", spdk_nvmf_subsystem_get_sn(subsystem)); 479 spdk_json_write_named_string(w, "model_number", spdk_nvmf_subsystem_get_mn(subsystem)); 480 481 max_namespaces = spdk_nvmf_subsystem_get_max_namespaces(subsystem); 482 if (max_namespaces != 0) { 483 spdk_json_write_named_uint32(w, "max_namespaces", max_namespaces); 484 } 485 486 spdk_json_write_named_uint32(w, "min_cntlid", spdk_nvmf_subsystem_get_min_cntlid(subsystem)); 487 spdk_json_write_named_uint32(w, "max_cntlid", spdk_nvmf_subsystem_get_max_cntlid(subsystem)); 488 spdk_json_write_named_bool(w, "ana_reporting", nvmf_subsystem_get_ana_reporting(subsystem)); 489 490 /* } "params" */ 491 spdk_json_write_object_end(w); 492 493 /* } */ 494 spdk_json_write_object_end(w); 495 496 for (host = spdk_nvmf_subsystem_get_first_host(subsystem); host != NULL; 497 host = spdk_nvmf_subsystem_get_next_host(subsystem, host)) { 498 499 spdk_json_write_object_begin(w); 500 spdk_json_write_named_string(w, "method", "nvmf_subsystem_add_host"); 501 502 /* "params" : { */ 503 spdk_json_write_named_object_begin(w, "params"); 504 505 spdk_json_write_named_string(w, "nqn", spdk_nvmf_subsystem_get_nqn(subsystem)); 506 spdk_json_write_named_string(w, "host", spdk_nvmf_host_get_nqn(host)); 507 508 /* } "params" */ 509 spdk_json_write_object_end(w); 510 511 /* } */ 512 spdk_json_write_object_end(w); 513 } 514 515 for (ns = spdk_nvmf_subsystem_get_first_ns(subsystem); ns != NULL; 516 ns = spdk_nvmf_subsystem_get_next_ns(subsystem, ns)) { 517 spdk_nvmf_ns_get_opts(ns, &ns_opts, sizeof(ns_opts)); 518 519 spdk_json_write_object_begin(w); 520 spdk_json_write_named_string(w, "method", "nvmf_subsystem_add_ns"); 521 522 /* "params" : { */ 523 spdk_json_write_named_object_begin(w, "params"); 524 525 spdk_json_write_named_string(w, "nqn", spdk_nvmf_subsystem_get_nqn(subsystem)); 526 527 /* "namespace" : { */ 528 spdk_json_write_named_object_begin(w, "namespace"); 529 530 spdk_json_write_named_uint32(w, "nsid", spdk_nvmf_ns_get_id(ns)); 531 spdk_json_write_named_string(w, "bdev_name", spdk_bdev_get_name(spdk_nvmf_ns_get_bdev(ns))); 532 533 if (!spdk_mem_all_zero(ns_opts.nguid, sizeof(ns_opts.nguid))) { 534 SPDK_STATIC_ASSERT(sizeof(ns_opts.nguid) == sizeof(uint64_t) * 2, "size mismatch"); 535 spdk_json_write_named_string_fmt(w, "nguid", "%016"PRIX64"%016"PRIX64, from_be64(&ns_opts.nguid[0]), 536 from_be64(&ns_opts.nguid[8])); 537 } 538 539 if (!spdk_mem_all_zero(ns_opts.eui64, sizeof(ns_opts.eui64))) { 540 SPDK_STATIC_ASSERT(sizeof(ns_opts.eui64) == sizeof(uint64_t), "size mismatch"); 541 spdk_json_write_named_string_fmt(w, "eui64", "%016"PRIX64, from_be64(&ns_opts.eui64)); 542 } 543 544 if (!spdk_mem_all_zero(&ns_opts.uuid, sizeof(ns_opts.uuid))) { 545 spdk_uuid_fmt_lower(uuid_str, sizeof(uuid_str), &ns_opts.uuid); 546 spdk_json_write_named_string(w, "uuid", uuid_str); 547 } 548 549 if (nvmf_subsystem_get_ana_reporting(subsystem)) { 550 spdk_json_write_named_uint32(w, "anagrpid", ns_opts.anagrpid); 551 } 552 553 /* "namespace" */ 554 spdk_json_write_object_end(w); 555 556 /* } "params" */ 557 spdk_json_write_object_end(w); 558 559 /* } */ 560 spdk_json_write_object_end(w); 561 } 562 563 for (listener = spdk_nvmf_subsystem_get_first_listener(subsystem); listener != NULL; 564 listener = spdk_nvmf_subsystem_get_next_listener(subsystem, listener)) { 565 trid = spdk_nvmf_subsystem_listener_get_trid(listener); 566 567 spdk_json_write_object_begin(w); 568 spdk_json_write_named_string(w, "method", "nvmf_subsystem_add_listener"); 569 570 /* "params" : { */ 571 spdk_json_write_named_object_begin(w, "params"); 572 573 spdk_json_write_named_string(w, "nqn", spdk_nvmf_subsystem_get_nqn(subsystem)); 574 nvmf_transport_listen_dump_opts(listener->transport, trid, w); 575 576 /* } "params" */ 577 spdk_json_write_object_end(w); 578 579 /* } */ 580 spdk_json_write_object_end(w); 581 } 582 583 } 584 585 void 586 spdk_nvmf_tgt_write_config_json(struct spdk_json_write_ctx *w, struct spdk_nvmf_tgt *tgt) 587 { 588 struct spdk_nvmf_subsystem *subsystem; 589 struct spdk_nvmf_transport *transport; 590 591 spdk_json_write_object_begin(w); 592 spdk_json_write_named_string(w, "method", "nvmf_set_max_subsystems"); 593 594 spdk_json_write_named_object_begin(w, "params"); 595 spdk_json_write_named_uint32(w, "max_subsystems", tgt->max_subsystems); 596 spdk_json_write_object_end(w); 597 598 spdk_json_write_object_end(w); 599 600 spdk_json_write_object_begin(w); 601 spdk_json_write_named_string(w, "method", "nvmf_set_crdt"); 602 spdk_json_write_named_object_begin(w, "params"); 603 spdk_json_write_named_uint32(w, "crdt1", tgt->crdt[0]); 604 spdk_json_write_named_uint32(w, "crdt2", tgt->crdt[1]); 605 spdk_json_write_named_uint32(w, "crdt3", tgt->crdt[2]); 606 spdk_json_write_object_end(w); 607 spdk_json_write_object_end(w); 608 609 /* write transports */ 610 TAILQ_FOREACH(transport, &tgt->transports, link) { 611 spdk_json_write_object_begin(w); 612 spdk_json_write_named_string(w, "method", "nvmf_create_transport"); 613 nvmf_transport_dump_opts(transport, w, true); 614 spdk_json_write_object_end(w); 615 } 616 617 subsystem = spdk_nvmf_subsystem_get_first(tgt); 618 while (subsystem) { 619 nvmf_write_subsystem_config_json(w, subsystem); 620 subsystem = spdk_nvmf_subsystem_get_next(subsystem); 621 } 622 } 623 624 static void 625 nvmf_listen_opts_copy(struct spdk_nvmf_listen_opts *opts, 626 const struct spdk_nvmf_listen_opts *opts_src, size_t opts_size) 627 { 628 assert(opts); 629 assert(opts_src); 630 631 opts->opts_size = opts_size; 632 633 #define SET_FIELD(field) \ 634 if (offsetof(struct spdk_nvmf_listen_opts, field) + sizeof(opts->field) <= opts_size) { \ 635 opts->field = opts_src->field; \ 636 } \ 637 638 SET_FIELD(transport_specific); 639 #undef SET_FIELD 640 641 /* Do not remove this statement, you should always update this statement when you adding a new field, 642 * and do not forget to add the SET_FIELD statement for your added field. */ 643 SPDK_STATIC_ASSERT(sizeof(struct spdk_nvmf_listen_opts) == 16, "Incorrect size"); 644 } 645 646 void 647 spdk_nvmf_listen_opts_init(struct spdk_nvmf_listen_opts *opts, size_t opts_size) 648 { 649 struct spdk_nvmf_listen_opts opts_local = {}; 650 651 /* local version of opts should have defaults set here */ 652 653 nvmf_listen_opts_copy(opts, &opts_local, opts_size); 654 } 655 656 int 657 spdk_nvmf_tgt_listen_ext(struct spdk_nvmf_tgt *tgt, const struct spdk_nvme_transport_id *trid, 658 struct spdk_nvmf_listen_opts *opts) 659 { 660 struct spdk_nvmf_transport *transport; 661 int rc; 662 struct spdk_nvmf_listen_opts opts_local = {}; 663 664 if (!opts) { 665 SPDK_ERRLOG("opts should not be NULL\n"); 666 return -EINVAL; 667 } 668 669 if (!opts->opts_size) { 670 SPDK_ERRLOG("The opts_size in opts structure should not be zero\n"); 671 return -EINVAL; 672 } 673 674 transport = spdk_nvmf_tgt_get_transport(tgt, trid->trstring); 675 if (!transport) { 676 SPDK_ERRLOG("Unable to find %s transport. The transport must be created first also make sure it is properly registered.\n", 677 trid->trstring); 678 return -EINVAL; 679 } 680 681 nvmf_listen_opts_copy(&opts_local, opts, opts->opts_size); 682 rc = spdk_nvmf_transport_listen(transport, trid, &opts_local); 683 if (rc < 0) { 684 SPDK_ERRLOG("Unable to listen on address '%s'\n", trid->traddr); 685 } 686 687 return rc; 688 } 689 690 int 691 spdk_nvmf_tgt_stop_listen(struct spdk_nvmf_tgt *tgt, 692 struct spdk_nvme_transport_id *trid) 693 { 694 struct spdk_nvmf_transport *transport; 695 int rc; 696 697 transport = spdk_nvmf_tgt_get_transport(tgt, trid->trstring); 698 if (!transport) { 699 SPDK_ERRLOG("Unable to find %s transport. The transport must be created first also make sure it is properly registered.\n", 700 trid->trstring); 701 return -EINVAL; 702 } 703 704 rc = spdk_nvmf_transport_stop_listen(transport, trid); 705 if (rc < 0) { 706 SPDK_ERRLOG("Failed to stop listening on address '%s'\n", trid->traddr); 707 return rc; 708 } 709 return 0; 710 } 711 712 struct spdk_nvmf_tgt_add_transport_ctx { 713 struct spdk_nvmf_tgt *tgt; 714 struct spdk_nvmf_transport *transport; 715 spdk_nvmf_tgt_add_transport_done_fn cb_fn; 716 void *cb_arg; 717 int status; 718 }; 719 720 static void 721 _nvmf_tgt_remove_transport_done(struct spdk_io_channel_iter *i, int status) 722 { 723 struct spdk_nvmf_tgt_add_transport_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 724 725 ctx->cb_fn(ctx->cb_arg, ctx->status); 726 free(ctx); 727 } 728 729 static void 730 _nvmf_tgt_remove_transport(struct spdk_io_channel_iter *i) 731 { 732 struct spdk_nvmf_tgt_add_transport_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 733 struct spdk_io_channel *ch = spdk_io_channel_iter_get_channel(i); 734 struct spdk_nvmf_poll_group *group = spdk_io_channel_get_ctx(ch); 735 struct spdk_nvmf_transport_poll_group *tgroup, *tmp; 736 737 TAILQ_FOREACH_SAFE(tgroup, &group->tgroups, link, tmp) { 738 if (tgroup->transport == ctx->transport) { 739 TAILQ_REMOVE(&group->tgroups, tgroup, link); 740 nvmf_transport_poll_group_destroy(tgroup); 741 } 742 } 743 744 spdk_for_each_channel_continue(i, 0); 745 } 746 747 static void 748 _nvmf_tgt_add_transport_done(struct spdk_io_channel_iter *i, int status) 749 { 750 struct spdk_nvmf_tgt_add_transport_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 751 752 if (status) { 753 ctx->status = status; 754 spdk_for_each_channel(ctx->tgt, 755 _nvmf_tgt_remove_transport, 756 ctx, 757 _nvmf_tgt_remove_transport_done); 758 return; 759 } 760 761 ctx->transport->tgt = ctx->tgt; 762 TAILQ_INSERT_TAIL(&ctx->tgt->transports, ctx->transport, link); 763 ctx->cb_fn(ctx->cb_arg, status); 764 free(ctx); 765 } 766 767 static void 768 _nvmf_tgt_add_transport(struct spdk_io_channel_iter *i) 769 { 770 struct spdk_nvmf_tgt_add_transport_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 771 struct spdk_io_channel *ch = spdk_io_channel_iter_get_channel(i); 772 struct spdk_nvmf_poll_group *group = spdk_io_channel_get_ctx(ch); 773 int rc; 774 775 rc = nvmf_poll_group_add_transport(group, ctx->transport); 776 spdk_for_each_channel_continue(i, rc); 777 } 778 779 void 780 spdk_nvmf_tgt_add_transport(struct spdk_nvmf_tgt *tgt, 781 struct spdk_nvmf_transport *transport, 782 spdk_nvmf_tgt_add_transport_done_fn cb_fn, 783 void *cb_arg) 784 { 785 struct spdk_nvmf_tgt_add_transport_ctx *ctx; 786 787 SPDK_DTRACE_PROBE2_TICKS(nvmf_tgt_add_transport, transport, tgt->name); 788 789 if (spdk_nvmf_tgt_get_transport(tgt, transport->ops->name)) { 790 cb_fn(cb_arg, -EEXIST); 791 return; /* transport already created */ 792 } 793 794 ctx = calloc(1, sizeof(*ctx)); 795 if (!ctx) { 796 cb_fn(cb_arg, -ENOMEM); 797 return; 798 } 799 800 ctx->tgt = tgt; 801 ctx->transport = transport; 802 ctx->cb_fn = cb_fn; 803 ctx->cb_arg = cb_arg; 804 805 spdk_for_each_channel(tgt, 806 _nvmf_tgt_add_transport, 807 ctx, 808 _nvmf_tgt_add_transport_done); 809 } 810 811 struct nvmf_tgt_pause_ctx { 812 struct spdk_nvmf_tgt *tgt; 813 spdk_nvmf_tgt_pause_polling_cb_fn cb_fn; 814 void *cb_arg; 815 }; 816 817 static void 818 _nvmf_tgt_pause_polling_done(struct spdk_io_channel_iter *i, int status) 819 { 820 struct nvmf_tgt_pause_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 821 822 ctx->tgt->state = NVMF_TGT_PAUSED; 823 824 ctx->cb_fn(ctx->cb_arg, status); 825 free(ctx); 826 } 827 828 static void 829 _nvmf_tgt_pause_polling(struct spdk_io_channel_iter *i) 830 { 831 struct spdk_io_channel *ch = spdk_io_channel_iter_get_channel(i); 832 struct spdk_nvmf_poll_group *group = spdk_io_channel_get_ctx(ch); 833 834 spdk_poller_unregister(&group->poller); 835 836 spdk_for_each_channel_continue(i, 0); 837 } 838 839 int 840 spdk_nvmf_tgt_pause_polling(struct spdk_nvmf_tgt *tgt, spdk_nvmf_tgt_pause_polling_cb_fn cb_fn, 841 void *cb_arg) 842 { 843 struct nvmf_tgt_pause_ctx *ctx; 844 845 SPDK_DTRACE_PROBE2_TICKS(nvmf_tgt_pause_polling, tgt, tgt->name); 846 847 switch (tgt->state) { 848 case NVMF_TGT_PAUSING: 849 case NVMF_TGT_RESUMING: 850 return -EBUSY; 851 case NVMF_TGT_RUNNING: 852 break; 853 default: 854 return -EINVAL; 855 } 856 857 ctx = calloc(1, sizeof(*ctx)); 858 if (!ctx) { 859 return -ENOMEM; 860 } 861 862 863 tgt->state = NVMF_TGT_PAUSING; 864 865 ctx->tgt = tgt; 866 ctx->cb_fn = cb_fn; 867 ctx->cb_arg = cb_arg; 868 869 spdk_for_each_channel(tgt, 870 _nvmf_tgt_pause_polling, 871 ctx, 872 _nvmf_tgt_pause_polling_done); 873 return 0; 874 } 875 876 static void 877 _nvmf_tgt_resume_polling_done(struct spdk_io_channel_iter *i, int status) 878 { 879 struct nvmf_tgt_pause_ctx *ctx = spdk_io_channel_iter_get_ctx(i); 880 881 ctx->tgt->state = NVMF_TGT_RUNNING; 882 883 ctx->cb_fn(ctx->cb_arg, status); 884 free(ctx); 885 } 886 887 static void 888 _nvmf_tgt_resume_polling(struct spdk_io_channel_iter *i) 889 { 890 struct spdk_io_channel *ch = spdk_io_channel_iter_get_channel(i); 891 struct spdk_nvmf_poll_group *group = spdk_io_channel_get_ctx(ch); 892 893 assert(group->poller == NULL); 894 group->poller = SPDK_POLLER_REGISTER(nvmf_poll_group_poll, group, 0); 895 896 spdk_for_each_channel_continue(i, 0); 897 } 898 899 int 900 spdk_nvmf_tgt_resume_polling(struct spdk_nvmf_tgt *tgt, spdk_nvmf_tgt_resume_polling_cb_fn cb_fn, 901 void *cb_arg) 902 { 903 struct nvmf_tgt_pause_ctx *ctx; 904 905 SPDK_DTRACE_PROBE2_TICKS(nvmf_tgt_resume_polling, tgt, tgt->name); 906 907 switch (tgt->state) { 908 case NVMF_TGT_PAUSING: 909 case NVMF_TGT_RESUMING: 910 return -EBUSY; 911 case NVMF_TGT_PAUSED: 912 break; 913 default: 914 return -EINVAL; 915 } 916 917 ctx = calloc(1, sizeof(*ctx)); 918 if (!ctx) { 919 return -ENOMEM; 920 } 921 922 tgt->state = NVMF_TGT_RESUMING; 923 924 ctx->tgt = tgt; 925 ctx->cb_fn = cb_fn; 926 ctx->cb_arg = cb_arg; 927 928 spdk_for_each_channel(tgt, 929 _nvmf_tgt_resume_polling, 930 ctx, 931 _nvmf_tgt_resume_polling_done); 932 return 0; 933 } 934 935 struct spdk_nvmf_subsystem * 936 spdk_nvmf_tgt_find_subsystem(struct spdk_nvmf_tgt *tgt, const char *subnqn) 937 { 938 struct spdk_nvmf_subsystem subsystem; 939 940 if (!subnqn) { 941 return NULL; 942 } 943 944 /* Ensure that subnqn is null terminated */ 945 if (!memchr(subnqn, '\0', SPDK_NVMF_NQN_MAX_LEN + 1)) { 946 SPDK_ERRLOG("Connect SUBNQN is not null terminated\n"); 947 return NULL; 948 } 949 950 snprintf(subsystem.subnqn, sizeof(subsystem.subnqn), "%s", subnqn); 951 return RB_FIND(subsystem_tree, &tgt->subsystems, &subsystem); 952 } 953 954 struct spdk_nvmf_transport * 955 spdk_nvmf_tgt_get_transport(struct spdk_nvmf_tgt *tgt, const char *transport_name) 956 { 957 struct spdk_nvmf_transport *transport; 958 959 TAILQ_FOREACH(transport, &tgt->transports, link) { 960 if (!strncasecmp(transport->ops->name, transport_name, SPDK_NVMF_TRSTRING_MAX_LEN)) { 961 return transport; 962 } 963 } 964 return NULL; 965 } 966 967 struct nvmf_new_qpair_ctx { 968 struct spdk_nvmf_qpair *qpair; 969 struct spdk_nvmf_poll_group *group; 970 }; 971 972 static void 973 _nvmf_poll_group_add(void *_ctx) 974 { 975 struct nvmf_new_qpair_ctx *ctx = _ctx; 976 struct spdk_nvmf_qpair *qpair = ctx->qpair; 977 struct spdk_nvmf_poll_group *group = ctx->group; 978 979 free(_ctx); 980 981 if (spdk_nvmf_poll_group_add(group, qpair) != 0) { 982 SPDK_ERRLOG("Unable to add the qpair to a poll group.\n"); 983 spdk_nvmf_qpair_disconnect(qpair, NULL, NULL); 984 } 985 } 986 987 void 988 spdk_nvmf_tgt_new_qpair(struct spdk_nvmf_tgt *tgt, struct spdk_nvmf_qpair *qpair) 989 { 990 struct spdk_nvmf_poll_group *group; 991 struct nvmf_new_qpair_ctx *ctx; 992 993 group = spdk_nvmf_get_optimal_poll_group(qpair); 994 if (group == NULL) { 995 if (tgt->next_poll_group == NULL) { 996 tgt->next_poll_group = TAILQ_FIRST(&tgt->poll_groups); 997 if (tgt->next_poll_group == NULL) { 998 SPDK_ERRLOG("No poll groups exist.\n"); 999 spdk_nvmf_qpair_disconnect(qpair, NULL, NULL); 1000 return; 1001 } 1002 } 1003 group = tgt->next_poll_group; 1004 tgt->next_poll_group = TAILQ_NEXT(group, link); 1005 } 1006 1007 ctx = calloc(1, sizeof(*ctx)); 1008 if (!ctx) { 1009 SPDK_ERRLOG("Unable to send message to poll group.\n"); 1010 spdk_nvmf_qpair_disconnect(qpair, NULL, NULL); 1011 return; 1012 } 1013 1014 ctx->qpair = qpair; 1015 ctx->group = group; 1016 1017 pthread_mutex_lock(&group->mutex); 1018 group->current_unassociated_qpairs++; 1019 pthread_mutex_unlock(&group->mutex); 1020 1021 spdk_thread_send_msg(group->thread, _nvmf_poll_group_add, ctx); 1022 } 1023 1024 struct spdk_nvmf_poll_group * 1025 spdk_nvmf_poll_group_create(struct spdk_nvmf_tgt *tgt) 1026 { 1027 struct spdk_io_channel *ch; 1028 1029 ch = spdk_get_io_channel(tgt); 1030 if (!ch) { 1031 SPDK_ERRLOG("Unable to get I/O channel for target\n"); 1032 return NULL; 1033 } 1034 1035 return spdk_io_channel_get_ctx(ch); 1036 } 1037 1038 void 1039 spdk_nvmf_poll_group_destroy(struct spdk_nvmf_poll_group *group, 1040 spdk_nvmf_poll_group_destroy_done_fn cb_fn, 1041 void *cb_arg) 1042 { 1043 assert(group->destroy_cb_fn == NULL); 1044 group->destroy_cb_fn = cb_fn; 1045 group->destroy_cb_arg = cb_arg; 1046 1047 /* This function will put the io_channel associated with this poll group */ 1048 nvmf_tgt_destroy_poll_group_qpairs(group); 1049 } 1050 1051 int 1052 spdk_nvmf_poll_group_add(struct spdk_nvmf_poll_group *group, 1053 struct spdk_nvmf_qpair *qpair) 1054 { 1055 int rc = -1; 1056 struct spdk_nvmf_transport_poll_group *tgroup; 1057 1058 TAILQ_INIT(&qpair->outstanding); 1059 qpair->group = group; 1060 qpair->ctrlr = NULL; 1061 qpair->disconnect_started = false; 1062 1063 TAILQ_FOREACH(tgroup, &group->tgroups, link) { 1064 if (tgroup->transport == qpair->transport) { 1065 rc = nvmf_transport_poll_group_add(tgroup, qpair); 1066 break; 1067 } 1068 } 1069 1070 /* We add the qpair to the group only it is successfully added into the tgroup */ 1071 if (rc == 0) { 1072 SPDK_DTRACE_PROBE2_TICKS(nvmf_poll_group_add_qpair, qpair, spdk_thread_get_id(group->thread)); 1073 TAILQ_INSERT_TAIL(&group->qpairs, qpair, link); 1074 nvmf_qpair_set_state(qpair, SPDK_NVMF_QPAIR_ACTIVE); 1075 } 1076 1077 return rc; 1078 } 1079 1080 static void 1081 _nvmf_ctrlr_destruct(void *ctx) 1082 { 1083 struct spdk_nvmf_ctrlr *ctrlr = ctx; 1084 1085 nvmf_ctrlr_destruct(ctrlr); 1086 } 1087 1088 static void 1089 _nvmf_ctrlr_free_from_qpair(void *ctx) 1090 { 1091 struct nvmf_qpair_disconnect_ctx *qpair_ctx = ctx; 1092 struct spdk_nvmf_ctrlr *ctrlr = qpair_ctx->ctrlr; 1093 uint32_t count; 1094 1095 spdk_bit_array_clear(ctrlr->qpair_mask, qpair_ctx->qid); 1096 count = spdk_bit_array_count_set(ctrlr->qpair_mask); 1097 if (count == 0) { 1098 assert(!ctrlr->in_destruct); 1099 SPDK_DEBUGLOG(nvmf, "Last qpair %u, destroy ctrlr 0x%hx\n", qpair_ctx->qid, ctrlr->cntlid); 1100 ctrlr->in_destruct = true; 1101 spdk_thread_send_msg(ctrlr->subsys->thread, _nvmf_ctrlr_destruct, ctrlr); 1102 } 1103 free(qpair_ctx); 1104 } 1105 1106 static void 1107 _nvmf_transport_qpair_fini_complete(void *cb_ctx) 1108 { 1109 struct nvmf_qpair_disconnect_ctx *qpair_ctx = cb_ctx; 1110 struct spdk_nvmf_ctrlr *ctrlr; 1111 /* Store cb args since cb_ctx can be freed in _nvmf_ctrlr_free_from_qpair */ 1112 nvmf_qpair_disconnect_cb cb_fn = qpair_ctx->cb_fn; 1113 void *cb_arg = qpair_ctx->ctx; 1114 struct spdk_thread *cb_thread = qpair_ctx->thread; 1115 1116 ctrlr = qpair_ctx->ctrlr; 1117 SPDK_DEBUGLOG(nvmf, "Finish destroying qid %u\n", qpair_ctx->qid); 1118 1119 if (ctrlr) { 1120 if (qpair_ctx->qid == 0) { 1121 /* Admin qpair is removed, so set the pointer to NULL. 1122 * This operation is safe since we are on ctrlr thread now, admin qpair's thread is the same 1123 * as controller's thread */ 1124 assert(ctrlr->thread == spdk_get_thread()); 1125 ctrlr->admin_qpair = NULL; 1126 } 1127 /* Free qpair id from controller's bit mask and destroy the controller if it is the last qpair */ 1128 if (ctrlr->thread) { 1129 spdk_thread_send_msg(ctrlr->thread, _nvmf_ctrlr_free_from_qpair, qpair_ctx); 1130 } else { 1131 _nvmf_ctrlr_free_from_qpair(qpair_ctx); 1132 } 1133 } else { 1134 free(qpair_ctx); 1135 } 1136 1137 if (cb_fn) { 1138 spdk_thread_send_msg(cb_thread, cb_fn, cb_arg); 1139 } 1140 } 1141 1142 void 1143 spdk_nvmf_poll_group_remove(struct spdk_nvmf_qpair *qpair) 1144 { 1145 struct spdk_nvmf_transport_poll_group *tgroup; 1146 int rc; 1147 1148 SPDK_DTRACE_PROBE2_TICKS(nvmf_poll_group_remove_qpair, qpair, 1149 spdk_thread_get_id(qpair->group->thread)); 1150 nvmf_qpair_set_state(qpair, SPDK_NVMF_QPAIR_ERROR); 1151 1152 /* Find the tgroup and remove the qpair from the tgroup */ 1153 TAILQ_FOREACH(tgroup, &qpair->group->tgroups, link) { 1154 if (tgroup->transport == qpair->transport) { 1155 rc = nvmf_transport_poll_group_remove(tgroup, qpair); 1156 if (rc && (rc != ENOTSUP)) { 1157 SPDK_ERRLOG("Cannot remove qpair=%p from transport group=%p\n", 1158 qpair, tgroup); 1159 } 1160 break; 1161 } 1162 } 1163 1164 TAILQ_REMOVE(&qpair->group->qpairs, qpair, link); 1165 qpair->group = NULL; 1166 } 1167 1168 static void 1169 _nvmf_qpair_sgroup_req_clean(struct spdk_nvmf_subsystem_poll_group *sgroup, 1170 const struct spdk_nvmf_qpair *qpair) 1171 { 1172 struct spdk_nvmf_request *req, *tmp; 1173 TAILQ_FOREACH_SAFE(req, &sgroup->queued, link, tmp) { 1174 if (req->qpair == qpair) { 1175 TAILQ_REMOVE(&sgroup->queued, req, link); 1176 if (nvmf_transport_req_free(req)) { 1177 SPDK_ERRLOG("Transport request free error!\n"); 1178 } 1179 } 1180 } 1181 } 1182 1183 static void 1184 _nvmf_qpair_destroy(void *ctx, int status) 1185 { 1186 struct nvmf_qpair_disconnect_ctx *qpair_ctx = ctx; 1187 struct spdk_nvmf_qpair *qpair = qpair_ctx->qpair; 1188 struct spdk_nvmf_ctrlr *ctrlr = qpair->ctrlr; 1189 struct spdk_nvmf_subsystem_poll_group *sgroup; 1190 uint32_t sid; 1191 1192 assert(qpair->state == SPDK_NVMF_QPAIR_DEACTIVATING); 1193 qpair_ctx->qid = qpair->qid; 1194 1195 if (qpair->connect_received) { 1196 if (0 == qpair->qid) { 1197 assert(qpair->group->stat.current_admin_qpairs > 0); 1198 qpair->group->stat.current_admin_qpairs--; 1199 } else { 1200 assert(qpair->group->stat.current_io_qpairs > 0); 1201 qpair->group->stat.current_io_qpairs--; 1202 } 1203 } else { 1204 pthread_mutex_lock(&qpair->group->mutex); 1205 qpair->group->current_unassociated_qpairs--; 1206 pthread_mutex_unlock(&qpair->group->mutex); 1207 } 1208 1209 if (ctrlr) { 1210 sgroup = &qpair->group->sgroups[ctrlr->subsys->id]; 1211 _nvmf_qpair_sgroup_req_clean(sgroup, qpair); 1212 } else { 1213 for (sid = 0; sid < qpair->group->num_sgroups; sid++) { 1214 sgroup = &qpair->group->sgroups[sid]; 1215 assert(sgroup != NULL); 1216 _nvmf_qpair_sgroup_req_clean(sgroup, qpair); 1217 } 1218 } 1219 1220 qpair_ctx->ctrlr = ctrlr; 1221 spdk_nvmf_poll_group_remove(qpair); 1222 nvmf_transport_qpair_fini(qpair, _nvmf_transport_qpair_fini_complete, qpair_ctx); 1223 } 1224 1225 static void 1226 _nvmf_qpair_disconnect_msg(void *ctx) 1227 { 1228 struct nvmf_qpair_disconnect_ctx *qpair_ctx = ctx; 1229 1230 spdk_nvmf_qpair_disconnect(qpair_ctx->qpair, qpair_ctx->cb_fn, qpair_ctx->ctx); 1231 free(ctx); 1232 } 1233 1234 SPDK_LOG_DEPRECATION_REGISTER(spdk_nvmf_qpair_disconnect, "cb_fn and ctx are deprecated", "v23.09", 1235 0); 1236 1237 int 1238 spdk_nvmf_qpair_disconnect(struct spdk_nvmf_qpair *qpair, nvmf_qpair_disconnect_cb cb_fn, void *ctx) 1239 { 1240 struct spdk_nvmf_poll_group *group = qpair->group; 1241 struct nvmf_qpair_disconnect_ctx *qpair_ctx; 1242 1243 if (__atomic_test_and_set(&qpair->disconnect_started, __ATOMIC_RELAXED)) { 1244 return -EINPROGRESS; 1245 } 1246 1247 if (cb_fn || ctx) { 1248 SPDK_LOG_DEPRECATED(spdk_nvmf_qpair_disconnect); 1249 } 1250 1251 /* If we get a qpair in the uninitialized state, we can just destroy it immediately */ 1252 if (qpair->state == SPDK_NVMF_QPAIR_UNINITIALIZED) { 1253 nvmf_transport_qpair_fini(qpair, NULL, NULL); 1254 if (cb_fn) { 1255 cb_fn(ctx); 1256 } 1257 return 0; 1258 } 1259 1260 assert(group != NULL); 1261 if (spdk_get_thread() != group->thread) { 1262 /* clear the atomic so we can set it on the next call on the proper thread. */ 1263 __atomic_clear(&qpair->disconnect_started, __ATOMIC_RELAXED); 1264 qpair_ctx = calloc(1, sizeof(struct nvmf_qpair_disconnect_ctx)); 1265 if (!qpair_ctx) { 1266 SPDK_ERRLOG("Unable to allocate context for nvmf_qpair_disconnect\n"); 1267 return -ENOMEM; 1268 } 1269 qpair_ctx->qpair = qpair; 1270 qpair_ctx->cb_fn = cb_fn; 1271 qpair_ctx->thread = group->thread; 1272 qpair_ctx->ctx = ctx; 1273 spdk_thread_send_msg(group->thread, _nvmf_qpair_disconnect_msg, qpair_ctx); 1274 return 0; 1275 } 1276 1277 SPDK_DTRACE_PROBE2_TICKS(nvmf_qpair_disconnect, qpair, spdk_thread_get_id(group->thread)); 1278 assert(qpair->state == SPDK_NVMF_QPAIR_ACTIVE); 1279 nvmf_qpair_set_state(qpair, SPDK_NVMF_QPAIR_DEACTIVATING); 1280 1281 qpair_ctx = calloc(1, sizeof(struct nvmf_qpair_disconnect_ctx)); 1282 if (!qpair_ctx) { 1283 SPDK_ERRLOG("Unable to allocate context for nvmf_qpair_disconnect\n"); 1284 return -ENOMEM; 1285 } 1286 1287 qpair_ctx->qpair = qpair; 1288 qpair_ctx->cb_fn = cb_fn; 1289 qpair_ctx->thread = group->thread; 1290 qpair_ctx->ctx = ctx; 1291 1292 /* Check for outstanding I/O */ 1293 if (!TAILQ_EMPTY(&qpair->outstanding)) { 1294 SPDK_DTRACE_PROBE2_TICKS(nvmf_poll_group_drain_qpair, qpair, spdk_thread_get_id(group->thread)); 1295 qpair->state_cb = _nvmf_qpair_destroy; 1296 qpair->state_cb_arg = qpair_ctx; 1297 nvmf_qpair_abort_pending_zcopy_reqs(qpair); 1298 nvmf_qpair_free_aer(qpair); 1299 return 0; 1300 } 1301 1302 _nvmf_qpair_destroy(qpair_ctx, 0); 1303 1304 return 0; 1305 } 1306 1307 int 1308 spdk_nvmf_qpair_get_peer_trid(struct spdk_nvmf_qpair *qpair, 1309 struct spdk_nvme_transport_id *trid) 1310 { 1311 memset(trid, 0, sizeof(*trid)); 1312 return nvmf_transport_qpair_get_peer_trid(qpair, trid); 1313 } 1314 1315 int 1316 spdk_nvmf_qpair_get_local_trid(struct spdk_nvmf_qpair *qpair, 1317 struct spdk_nvme_transport_id *trid) 1318 { 1319 memset(trid, 0, sizeof(*trid)); 1320 return nvmf_transport_qpair_get_local_trid(qpair, trid); 1321 } 1322 1323 int 1324 spdk_nvmf_qpair_get_listen_trid(struct spdk_nvmf_qpair *qpair, 1325 struct spdk_nvme_transport_id *trid) 1326 { 1327 memset(trid, 0, sizeof(*trid)); 1328 return nvmf_transport_qpair_get_listen_trid(qpair, trid); 1329 } 1330 1331 static int 1332 poll_group_update_subsystem(struct spdk_nvmf_poll_group *group, 1333 struct spdk_nvmf_subsystem *subsystem) 1334 { 1335 struct spdk_nvmf_subsystem_poll_group *sgroup; 1336 uint32_t new_num_ns, old_num_ns; 1337 uint32_t i, j; 1338 struct spdk_nvmf_ns *ns; 1339 struct spdk_nvmf_registrant *reg, *tmp; 1340 struct spdk_io_channel *ch; 1341 struct spdk_nvmf_subsystem_pg_ns_info *ns_info; 1342 struct spdk_nvmf_ctrlr *ctrlr; 1343 bool ns_changed; 1344 1345 /* Make sure our poll group has memory for this subsystem allocated */ 1346 if (subsystem->id >= group->num_sgroups) { 1347 return -ENOMEM; 1348 } 1349 1350 sgroup = &group->sgroups[subsystem->id]; 1351 1352 /* Make sure the array of namespace information is the correct size */ 1353 new_num_ns = subsystem->max_nsid; 1354 old_num_ns = sgroup->num_ns; 1355 1356 ns_changed = false; 1357 1358 if (old_num_ns == 0) { 1359 if (new_num_ns > 0) { 1360 /* First allocation */ 1361 sgroup->ns_info = calloc(new_num_ns, sizeof(struct spdk_nvmf_subsystem_pg_ns_info)); 1362 if (!sgroup->ns_info) { 1363 return -ENOMEM; 1364 } 1365 } 1366 } else if (new_num_ns > old_num_ns) { 1367 void *buf; 1368 1369 /* Make the array larger */ 1370 buf = realloc(sgroup->ns_info, new_num_ns * sizeof(struct spdk_nvmf_subsystem_pg_ns_info)); 1371 if (!buf) { 1372 return -ENOMEM; 1373 } 1374 1375 sgroup->ns_info = buf; 1376 1377 /* Null out the new namespace information slots */ 1378 for (i = old_num_ns; i < new_num_ns; i++) { 1379 memset(&sgroup->ns_info[i], 0, sizeof(struct spdk_nvmf_subsystem_pg_ns_info)); 1380 } 1381 } else if (new_num_ns < old_num_ns) { 1382 void *buf; 1383 1384 /* Free the extra I/O channels */ 1385 for (i = new_num_ns; i < old_num_ns; i++) { 1386 ns_info = &sgroup->ns_info[i]; 1387 1388 if (ns_info->channel) { 1389 spdk_put_io_channel(ns_info->channel); 1390 ns_info->channel = NULL; 1391 } 1392 } 1393 1394 /* Make the array smaller */ 1395 if (new_num_ns > 0) { 1396 buf = realloc(sgroup->ns_info, new_num_ns * sizeof(struct spdk_nvmf_subsystem_pg_ns_info)); 1397 if (!buf) { 1398 return -ENOMEM; 1399 } 1400 sgroup->ns_info = buf; 1401 } else { 1402 free(sgroup->ns_info); 1403 sgroup->ns_info = NULL; 1404 } 1405 } 1406 1407 sgroup->num_ns = new_num_ns; 1408 1409 /* Detect bdevs that were added or removed */ 1410 for (i = 0; i < sgroup->num_ns; i++) { 1411 ns = subsystem->ns[i]; 1412 ns_info = &sgroup->ns_info[i]; 1413 ch = ns_info->channel; 1414 1415 if (ns == NULL && ch == NULL) { 1416 /* Both NULL. Leave empty */ 1417 } else if (ns == NULL && ch != NULL) { 1418 /* There was a channel here, but the namespace is gone. */ 1419 ns_changed = true; 1420 spdk_put_io_channel(ch); 1421 ns_info->channel = NULL; 1422 } else if (ns != NULL && ch == NULL) { 1423 /* A namespace appeared but there is no channel yet */ 1424 ns_changed = true; 1425 ch = spdk_bdev_get_io_channel(ns->desc); 1426 if (ch == NULL) { 1427 SPDK_ERRLOG("Could not allocate I/O channel.\n"); 1428 return -ENOMEM; 1429 } 1430 ns_info->channel = ch; 1431 } else if (spdk_uuid_compare(&ns_info->uuid, spdk_bdev_get_uuid(ns->bdev)) != 0) { 1432 /* A namespace was here before, but was replaced by a new one. */ 1433 ns_changed = true; 1434 spdk_put_io_channel(ns_info->channel); 1435 memset(ns_info, 0, sizeof(*ns_info)); 1436 1437 ch = spdk_bdev_get_io_channel(ns->desc); 1438 if (ch == NULL) { 1439 SPDK_ERRLOG("Could not allocate I/O channel.\n"); 1440 return -ENOMEM; 1441 } 1442 ns_info->channel = ch; 1443 } else if (ns_info->num_blocks != spdk_bdev_get_num_blocks(ns->bdev)) { 1444 /* Namespace is still there but size has changed */ 1445 SPDK_DEBUGLOG(nvmf, "Namespace resized: subsystem_id %u," 1446 " nsid %u, pg %p, old %" PRIu64 ", new %" PRIu64 "\n", 1447 subsystem->id, 1448 ns->nsid, 1449 group, 1450 ns_info->num_blocks, 1451 spdk_bdev_get_num_blocks(ns->bdev)); 1452 ns_changed = true; 1453 } 1454 1455 if (ns == NULL) { 1456 memset(ns_info, 0, sizeof(*ns_info)); 1457 } else { 1458 ns_info->uuid = *spdk_bdev_get_uuid(ns->bdev); 1459 ns_info->num_blocks = spdk_bdev_get_num_blocks(ns->bdev); 1460 ns_info->crkey = ns->crkey; 1461 ns_info->rtype = ns->rtype; 1462 if (ns->holder) { 1463 ns_info->holder_id = ns->holder->hostid; 1464 } 1465 1466 memset(&ns_info->reg_hostid, 0, SPDK_NVMF_MAX_NUM_REGISTRANTS * sizeof(struct spdk_uuid)); 1467 j = 0; 1468 TAILQ_FOREACH_SAFE(reg, &ns->registrants, link, tmp) { 1469 if (j >= SPDK_NVMF_MAX_NUM_REGISTRANTS) { 1470 SPDK_ERRLOG("Maximum %u registrants can support.\n", SPDK_NVMF_MAX_NUM_REGISTRANTS); 1471 return -EINVAL; 1472 } 1473 ns_info->reg_hostid[j++] = reg->hostid; 1474 } 1475 } 1476 } 1477 1478 if (ns_changed) { 1479 TAILQ_FOREACH(ctrlr, &subsystem->ctrlrs, link) { 1480 /* It is possible that a ctrlr was added but the admin_qpair hasn't been 1481 * assigned yet. 1482 */ 1483 if (!ctrlr->admin_qpair) { 1484 continue; 1485 } 1486 if (ctrlr->admin_qpair->group == group) { 1487 nvmf_ctrlr_async_event_ns_notice(ctrlr); 1488 nvmf_ctrlr_async_event_ana_change_notice(ctrlr); 1489 } 1490 } 1491 } 1492 1493 return 0; 1494 } 1495 1496 int 1497 nvmf_poll_group_update_subsystem(struct spdk_nvmf_poll_group *group, 1498 struct spdk_nvmf_subsystem *subsystem) 1499 { 1500 return poll_group_update_subsystem(group, subsystem); 1501 } 1502 1503 int 1504 nvmf_poll_group_add_subsystem(struct spdk_nvmf_poll_group *group, 1505 struct spdk_nvmf_subsystem *subsystem, 1506 spdk_nvmf_poll_group_mod_done cb_fn, void *cb_arg) 1507 { 1508 int rc = 0; 1509 struct spdk_nvmf_subsystem_poll_group *sgroup = &group->sgroups[subsystem->id]; 1510 uint32_t i; 1511 1512 TAILQ_INIT(&sgroup->queued); 1513 1514 rc = poll_group_update_subsystem(group, subsystem); 1515 if (rc) { 1516 nvmf_poll_group_remove_subsystem(group, subsystem, NULL, NULL); 1517 goto fini; 1518 } 1519 1520 sgroup->state = SPDK_NVMF_SUBSYSTEM_ACTIVE; 1521 1522 for (i = 0; i < sgroup->num_ns; i++) { 1523 sgroup->ns_info[i].state = SPDK_NVMF_SUBSYSTEM_ACTIVE; 1524 } 1525 1526 fini: 1527 if (cb_fn) { 1528 cb_fn(cb_arg, rc); 1529 } 1530 1531 SPDK_DTRACE_PROBE2_TICKS(nvmf_poll_group_add_subsystem, spdk_thread_get_id(group->thread), 1532 subsystem->subnqn); 1533 1534 return rc; 1535 } 1536 1537 static void 1538 _nvmf_poll_group_remove_subsystem_cb(void *ctx, int status) 1539 { 1540 struct nvmf_qpair_disconnect_many_ctx *qpair_ctx = ctx; 1541 struct spdk_nvmf_subsystem *subsystem; 1542 struct spdk_nvmf_poll_group *group; 1543 struct spdk_nvmf_subsystem_poll_group *sgroup; 1544 spdk_nvmf_poll_group_mod_done cpl_fn = NULL; 1545 void *cpl_ctx = NULL; 1546 uint32_t nsid; 1547 1548 group = qpair_ctx->group; 1549 subsystem = qpair_ctx->subsystem; 1550 cpl_fn = qpair_ctx->cpl_fn; 1551 cpl_ctx = qpair_ctx->cpl_ctx; 1552 sgroup = &group->sgroups[subsystem->id]; 1553 1554 if (status) { 1555 goto fini; 1556 } 1557 1558 for (nsid = 0; nsid < sgroup->num_ns; nsid++) { 1559 if (sgroup->ns_info[nsid].channel) { 1560 spdk_put_io_channel(sgroup->ns_info[nsid].channel); 1561 sgroup->ns_info[nsid].channel = NULL; 1562 } 1563 } 1564 1565 sgroup->num_ns = 0; 1566 free(sgroup->ns_info); 1567 sgroup->ns_info = NULL; 1568 fini: 1569 free(qpair_ctx); 1570 if (cpl_fn) { 1571 cpl_fn(cpl_ctx, status); 1572 } 1573 } 1574 1575 static void nvmf_poll_group_remove_subsystem_msg(void *ctx); 1576 1577 static void 1578 nvmf_poll_group_remove_subsystem_msg(void *ctx) 1579 { 1580 struct spdk_nvmf_qpair *qpair, *qpair_tmp; 1581 struct spdk_nvmf_subsystem *subsystem; 1582 struct spdk_nvmf_poll_group *group; 1583 struct nvmf_qpair_disconnect_many_ctx *qpair_ctx = ctx; 1584 bool qpairs_found = false; 1585 int rc = 0; 1586 1587 group = qpair_ctx->group; 1588 subsystem = qpair_ctx->subsystem; 1589 1590 TAILQ_FOREACH_SAFE(qpair, &group->qpairs, link, qpair_tmp) { 1591 if ((qpair->ctrlr != NULL) && (qpair->ctrlr->subsys == subsystem)) { 1592 qpairs_found = true; 1593 rc = spdk_nvmf_qpair_disconnect(qpair, NULL, NULL); 1594 if (rc && rc != -EINPROGRESS) { 1595 break; 1596 } 1597 } 1598 } 1599 1600 if (!qpairs_found) { 1601 _nvmf_poll_group_remove_subsystem_cb(ctx, 0); 1602 return; 1603 } 1604 1605 /* Some qpairs are in process of being disconnected. Send a message and try to remove them again */ 1606 spdk_thread_send_msg(spdk_get_thread(), nvmf_poll_group_remove_subsystem_msg, ctx); 1607 } 1608 1609 void 1610 nvmf_poll_group_remove_subsystem(struct spdk_nvmf_poll_group *group, 1611 struct spdk_nvmf_subsystem *subsystem, 1612 spdk_nvmf_poll_group_mod_done cb_fn, void *cb_arg) 1613 { 1614 struct spdk_nvmf_subsystem_poll_group *sgroup; 1615 struct nvmf_qpair_disconnect_many_ctx *ctx; 1616 uint32_t i; 1617 1618 SPDK_DTRACE_PROBE3_TICKS(nvmf_poll_group_remove_subsystem, group, spdk_thread_get_id(group->thread), 1619 subsystem->subnqn); 1620 1621 ctx = calloc(1, sizeof(struct nvmf_qpair_disconnect_many_ctx)); 1622 if (!ctx) { 1623 SPDK_ERRLOG("Unable to allocate memory for context to remove poll subsystem\n"); 1624 if (cb_fn) { 1625 cb_fn(cb_arg, -1); 1626 } 1627 return; 1628 } 1629 1630 ctx->group = group; 1631 ctx->subsystem = subsystem; 1632 ctx->cpl_fn = cb_fn; 1633 ctx->cpl_ctx = cb_arg; 1634 1635 sgroup = &group->sgroups[subsystem->id]; 1636 sgroup->state = SPDK_NVMF_SUBSYSTEM_INACTIVE; 1637 1638 for (i = 0; i < sgroup->num_ns; i++) { 1639 sgroup->ns_info[i].state = SPDK_NVMF_SUBSYSTEM_INACTIVE; 1640 } 1641 1642 nvmf_poll_group_remove_subsystem_msg(ctx); 1643 } 1644 1645 void 1646 nvmf_poll_group_pause_subsystem(struct spdk_nvmf_poll_group *group, 1647 struct spdk_nvmf_subsystem *subsystem, 1648 uint32_t nsid, 1649 spdk_nvmf_poll_group_mod_done cb_fn, void *cb_arg) 1650 { 1651 struct spdk_nvmf_subsystem_poll_group *sgroup; 1652 struct spdk_nvmf_subsystem_pg_ns_info *ns_info = NULL; 1653 int rc = 0; 1654 uint32_t i; 1655 1656 if (subsystem->id >= group->num_sgroups) { 1657 rc = -1; 1658 goto fini; 1659 } 1660 1661 sgroup = &group->sgroups[subsystem->id]; 1662 if (sgroup->state == SPDK_NVMF_SUBSYSTEM_PAUSED) { 1663 goto fini; 1664 } 1665 sgroup->state = SPDK_NVMF_SUBSYSTEM_PAUSING; 1666 1667 if (nsid == SPDK_NVME_GLOBAL_NS_TAG) { 1668 for (i = 0; i < sgroup->num_ns; i++) { 1669 ns_info = &sgroup->ns_info[i]; 1670 ns_info->state = SPDK_NVMF_SUBSYSTEM_PAUSING; 1671 } 1672 } else { 1673 /* NOTE: This implicitly also checks for 0, since 0 - 1 wraps around to UINT32_MAX. */ 1674 if (nsid - 1 < sgroup->num_ns) { 1675 ns_info = &sgroup->ns_info[nsid - 1]; 1676 ns_info->state = SPDK_NVMF_SUBSYSTEM_PAUSING; 1677 } 1678 } 1679 1680 if (sgroup->mgmt_io_outstanding > 0) { 1681 assert(sgroup->cb_fn == NULL); 1682 sgroup->cb_fn = cb_fn; 1683 assert(sgroup->cb_arg == NULL); 1684 sgroup->cb_arg = cb_arg; 1685 return; 1686 } 1687 1688 if (nsid == SPDK_NVME_GLOBAL_NS_TAG) { 1689 for (i = 0; i < sgroup->num_ns; i++) { 1690 ns_info = &sgroup->ns_info[i]; 1691 1692 if (ns_info->io_outstanding > 0) { 1693 assert(sgroup->cb_fn == NULL); 1694 sgroup->cb_fn = cb_fn; 1695 assert(sgroup->cb_arg == NULL); 1696 sgroup->cb_arg = cb_arg; 1697 return; 1698 } 1699 } 1700 } else { 1701 if (ns_info != NULL && ns_info->io_outstanding > 0) { 1702 assert(sgroup->cb_fn == NULL); 1703 sgroup->cb_fn = cb_fn; 1704 assert(sgroup->cb_arg == NULL); 1705 sgroup->cb_arg = cb_arg; 1706 return; 1707 } 1708 } 1709 1710 assert(sgroup->mgmt_io_outstanding == 0); 1711 sgroup->state = SPDK_NVMF_SUBSYSTEM_PAUSED; 1712 fini: 1713 if (cb_fn) { 1714 cb_fn(cb_arg, rc); 1715 } 1716 } 1717 1718 void 1719 nvmf_poll_group_resume_subsystem(struct spdk_nvmf_poll_group *group, 1720 struct spdk_nvmf_subsystem *subsystem, 1721 spdk_nvmf_poll_group_mod_done cb_fn, void *cb_arg) 1722 { 1723 struct spdk_nvmf_request *req, *tmp; 1724 struct spdk_nvmf_subsystem_poll_group *sgroup; 1725 int rc = 0; 1726 uint32_t i; 1727 1728 if (subsystem->id >= group->num_sgroups) { 1729 rc = -1; 1730 goto fini; 1731 } 1732 1733 sgroup = &group->sgroups[subsystem->id]; 1734 1735 if (sgroup->state == SPDK_NVMF_SUBSYSTEM_ACTIVE) { 1736 goto fini; 1737 } 1738 1739 rc = poll_group_update_subsystem(group, subsystem); 1740 if (rc) { 1741 goto fini; 1742 } 1743 1744 for (i = 0; i < sgroup->num_ns; i++) { 1745 sgroup->ns_info[i].state = SPDK_NVMF_SUBSYSTEM_ACTIVE; 1746 } 1747 1748 sgroup->state = SPDK_NVMF_SUBSYSTEM_ACTIVE; 1749 1750 /* Release all queued requests */ 1751 TAILQ_FOREACH_SAFE(req, &sgroup->queued, link, tmp) { 1752 TAILQ_REMOVE(&sgroup->queued, req, link); 1753 if (spdk_nvmf_request_using_zcopy(req)) { 1754 spdk_nvmf_request_zcopy_start(req); 1755 } else { 1756 spdk_nvmf_request_exec(req); 1757 } 1758 1759 } 1760 fini: 1761 if (cb_fn) { 1762 cb_fn(cb_arg, rc); 1763 } 1764 } 1765 1766 1767 struct spdk_nvmf_poll_group * 1768 spdk_nvmf_get_optimal_poll_group(struct spdk_nvmf_qpair *qpair) 1769 { 1770 struct spdk_nvmf_transport_poll_group *tgroup; 1771 1772 tgroup = nvmf_transport_get_optimal_poll_group(qpair->transport, qpair); 1773 1774 if (tgroup == NULL) { 1775 return NULL; 1776 } 1777 1778 return tgroup->group; 1779 } 1780 1781 void 1782 spdk_nvmf_poll_group_dump_stat(struct spdk_nvmf_poll_group *group, struct spdk_json_write_ctx *w) 1783 { 1784 struct spdk_nvmf_transport_poll_group *tgroup; 1785 1786 spdk_json_write_object_begin(w); 1787 1788 spdk_json_write_named_string(w, "name", spdk_thread_get_name(spdk_get_thread())); 1789 spdk_json_write_named_uint32(w, "admin_qpairs", group->stat.admin_qpairs); 1790 spdk_json_write_named_uint32(w, "io_qpairs", group->stat.io_qpairs); 1791 spdk_json_write_named_uint32(w, "current_admin_qpairs", group->stat.current_admin_qpairs); 1792 spdk_json_write_named_uint32(w, "current_io_qpairs", group->stat.current_io_qpairs); 1793 spdk_json_write_named_uint64(w, "pending_bdev_io", group->stat.pending_bdev_io); 1794 spdk_json_write_named_uint64(w, "completed_nvme_io", group->stat.completed_nvme_io); 1795 1796 spdk_json_write_named_array_begin(w, "transports"); 1797 1798 TAILQ_FOREACH(tgroup, &group->tgroups, link) { 1799 spdk_json_write_object_begin(w); 1800 /* 1801 * The trtype field intentionally contains a transport name as this is more informative. 1802 * The field has not been renamed for backward compatibility. 1803 */ 1804 spdk_json_write_named_string(w, "trtype", spdk_nvmf_get_transport_name(tgroup->transport)); 1805 1806 if (tgroup->transport->ops->poll_group_dump_stat) { 1807 tgroup->transport->ops->poll_group_dump_stat(tgroup, w); 1808 } 1809 1810 spdk_json_write_object_end(w); 1811 } 1812 1813 spdk_json_write_array_end(w); 1814 spdk_json_write_object_end(w); 1815 } 1816