1 /*- 2 * BSD LICENSE 3 * 4 * Copyright (c) Intel Corporation. 5 * All rights reserved. 6 * 7 * Redistribution and use in source and binary forms, with or without 8 * modification, are permitted provided that the following conditions 9 * are met: 10 * 11 * * Redistributions of source code must retain the above copyright 12 * notice, this list of conditions and the following disclaimer. 13 * * Redistributions in binary form must reproduce the above copyright 14 * notice, this list of conditions and the following disclaimer in 15 * the documentation and/or other materials provided with the 16 * distribution. 17 * * Neither the name of Intel Corporation nor the names of its 18 * contributors may be used to endorse or promote products derived 19 * from this software without specific prior written permission. 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 22 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 23 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 24 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 25 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 26 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 27 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 28 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 29 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 31 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 32 */ 33 34 #include "spdk_cunit.h" 35 36 #include "common/lib/test_env.c" 37 #include "common/lib/ut_multithread.c" 38 #include "unit/lib/json_mock.c" 39 40 /* HACK: disable VTune integration so the unit test doesn't need VTune headers and libs to build */ 41 #undef SPDK_CONFIG_VTUNE 42 43 #include "bdev/bdev.c" 44 45 #define BDEV_UT_NUM_THREADS 3 46 47 DEFINE_STUB_V(spdk_scsi_nvme_translate, (const struct spdk_bdev_io *bdev_io, 48 int *sc, int *sk, int *asc, int *ascq)); 49 50 /* Return NULL to test hardcoded defaults. */ 51 struct spdk_conf_section * 52 spdk_conf_find_section(struct spdk_conf *cp, const char *name) 53 { 54 return NULL; 55 } 56 57 /* Return NULL to test hardcoded defaults. */ 58 char * 59 spdk_conf_section_get_nmval(struct spdk_conf_section *sp, const char *key, int idx1, int idx2) 60 { 61 return NULL; 62 } 63 64 struct ut_bdev { 65 struct spdk_bdev bdev; 66 void *io_target; 67 }; 68 69 struct ut_bdev_channel { 70 TAILQ_HEAD(, spdk_bdev_io) outstanding_io; 71 uint32_t outstanding_cnt; 72 uint32_t avail_cnt; 73 }; 74 75 int g_io_device; 76 struct ut_bdev g_bdev; 77 struct spdk_bdev_desc *g_desc; 78 bool g_teardown_done = false; 79 bool g_get_io_channel = true; 80 bool g_create_ch = true; 81 bool g_init_complete_called = false; 82 83 static int 84 stub_create_ch(void *io_device, void *ctx_buf) 85 { 86 struct ut_bdev_channel *ch = ctx_buf; 87 88 if (g_create_ch == false) { 89 return -1; 90 } 91 92 TAILQ_INIT(&ch->outstanding_io); 93 ch->outstanding_cnt = 0; 94 /* 95 * When avail gets to 0, the submit_request function will return ENOMEM. 96 * Most tests to not want ENOMEM to occur, so by default set this to a 97 * big value that won't get hit. The ENOMEM tests can then override this 98 * value to something much smaller to induce ENOMEM conditions. 99 */ 100 ch->avail_cnt = 2048; 101 return 0; 102 } 103 104 static void 105 stub_destroy_ch(void *io_device, void *ctx_buf) 106 { 107 } 108 109 static struct spdk_io_channel * 110 stub_get_io_channel(void *ctx) 111 { 112 struct ut_bdev *ut_bdev = ctx; 113 114 if (g_get_io_channel == true) { 115 return spdk_get_io_channel(ut_bdev->io_target); 116 } else { 117 return NULL; 118 } 119 } 120 121 static int 122 stub_destruct(void *ctx) 123 { 124 return 0; 125 } 126 127 static void 128 stub_submit_request(struct spdk_io_channel *_ch, struct spdk_bdev_io *bdev_io) 129 { 130 struct ut_bdev_channel *ch = spdk_io_channel_get_ctx(_ch); 131 132 if (bdev_io->type == SPDK_BDEV_IO_TYPE_RESET) { 133 struct spdk_bdev_io *io; 134 135 while (!TAILQ_EMPTY(&ch->outstanding_io)) { 136 io = TAILQ_FIRST(&ch->outstanding_io); 137 TAILQ_REMOVE(&ch->outstanding_io, io, module_link); 138 ch->outstanding_cnt--; 139 spdk_bdev_io_complete(io, SPDK_BDEV_IO_STATUS_FAILED); 140 ch->avail_cnt++; 141 } 142 } 143 144 if (ch->avail_cnt > 0) { 145 TAILQ_INSERT_TAIL(&ch->outstanding_io, bdev_io, module_link); 146 ch->outstanding_cnt++; 147 ch->avail_cnt--; 148 } else { 149 spdk_bdev_io_complete(bdev_io, SPDK_BDEV_IO_STATUS_NOMEM); 150 } 151 } 152 153 static uint32_t 154 stub_complete_io(void *io_target, uint32_t num_to_complete) 155 { 156 struct spdk_io_channel *_ch = spdk_get_io_channel(io_target); 157 struct ut_bdev_channel *ch = spdk_io_channel_get_ctx(_ch); 158 struct spdk_bdev_io *io; 159 bool complete_all = (num_to_complete == 0); 160 uint32_t num_completed = 0; 161 162 while (complete_all || num_completed < num_to_complete) { 163 if (TAILQ_EMPTY(&ch->outstanding_io)) { 164 break; 165 } 166 io = TAILQ_FIRST(&ch->outstanding_io); 167 TAILQ_REMOVE(&ch->outstanding_io, io, module_link); 168 ch->outstanding_cnt--; 169 spdk_bdev_io_complete(io, SPDK_BDEV_IO_STATUS_SUCCESS); 170 ch->avail_cnt++; 171 num_completed++; 172 } 173 174 spdk_put_io_channel(_ch); 175 return num_completed; 176 } 177 178 static struct spdk_bdev_fn_table fn_table = { 179 .get_io_channel = stub_get_io_channel, 180 .destruct = stub_destruct, 181 .submit_request = stub_submit_request, 182 }; 183 184 static int 185 module_init(void) 186 { 187 return 0; 188 } 189 190 static void 191 module_fini(void) 192 { 193 } 194 195 static void 196 init_complete(void) 197 { 198 g_init_complete_called = true; 199 } 200 201 struct spdk_bdev_module bdev_ut_if = { 202 .name = "bdev_ut", 203 .module_init = module_init, 204 .module_fini = module_fini, 205 .init_complete = init_complete, 206 }; 207 208 SPDK_BDEV_MODULE_REGISTER(&bdev_ut_if) 209 210 static void 211 register_bdev(struct ut_bdev *ut_bdev, char *name, void *io_target) 212 { 213 memset(ut_bdev, 0, sizeof(*ut_bdev)); 214 215 ut_bdev->io_target = io_target; 216 ut_bdev->bdev.ctxt = ut_bdev; 217 ut_bdev->bdev.name = name; 218 ut_bdev->bdev.fn_table = &fn_table; 219 ut_bdev->bdev.module = &bdev_ut_if; 220 ut_bdev->bdev.blocklen = 4096; 221 ut_bdev->bdev.blockcnt = 1024; 222 223 spdk_bdev_register(&ut_bdev->bdev); 224 } 225 226 static void 227 unregister_bdev(struct ut_bdev *ut_bdev) 228 { 229 /* Handle any deferred messages. */ 230 poll_threads(); 231 spdk_bdev_unregister(&ut_bdev->bdev, NULL, NULL); 232 } 233 234 static void 235 bdev_init_cb(void *done, int rc) 236 { 237 CU_ASSERT(rc == 0); 238 *(bool *)done = true; 239 } 240 241 static void 242 setup_test(void) 243 { 244 bool done = false; 245 246 allocate_threads(BDEV_UT_NUM_THREADS); 247 spdk_bdev_initialize(bdev_init_cb, &done); 248 spdk_io_device_register(&g_io_device, stub_create_ch, stub_destroy_ch, 249 sizeof(struct ut_bdev_channel)); 250 register_bdev(&g_bdev, "ut_bdev", &g_io_device); 251 spdk_bdev_open(&g_bdev.bdev, true, NULL, NULL, &g_desc); 252 } 253 254 static void 255 finish_cb(void *cb_arg) 256 { 257 g_teardown_done = true; 258 } 259 260 static void 261 teardown_test(void) 262 { 263 g_teardown_done = false; 264 spdk_bdev_close(g_desc); 265 g_desc = NULL; 266 unregister_bdev(&g_bdev); 267 spdk_io_device_unregister(&g_io_device, NULL); 268 spdk_bdev_finish(finish_cb, NULL); 269 poll_threads(); 270 memset(&g_bdev, 0, sizeof(g_bdev)); 271 CU_ASSERT(g_teardown_done == true); 272 g_teardown_done = false; 273 free_threads(); 274 } 275 276 static uint32_t 277 bdev_io_tailq_cnt(bdev_io_tailq_t *tailq) 278 { 279 struct spdk_bdev_io *io; 280 uint32_t cnt = 0; 281 282 TAILQ_FOREACH(io, tailq, link) { 283 cnt++; 284 } 285 286 return cnt; 287 } 288 289 static void 290 basic(void) 291 { 292 g_init_complete_called = false; 293 setup_test(); 294 CU_ASSERT(g_init_complete_called == true); 295 296 set_thread(0); 297 298 g_get_io_channel = false; 299 g_ut_threads[0].ch = spdk_bdev_get_io_channel(g_desc); 300 CU_ASSERT(g_ut_threads[0].ch == NULL); 301 302 g_get_io_channel = true; 303 g_create_ch = false; 304 g_ut_threads[0].ch = spdk_bdev_get_io_channel(g_desc); 305 CU_ASSERT(g_ut_threads[0].ch == NULL); 306 307 g_get_io_channel = true; 308 g_create_ch = true; 309 g_ut_threads[0].ch = spdk_bdev_get_io_channel(g_desc); 310 CU_ASSERT(g_ut_threads[0].ch != NULL); 311 spdk_put_io_channel(g_ut_threads[0].ch); 312 313 teardown_test(); 314 } 315 316 static int 317 poller_run_done(void *ctx) 318 { 319 bool *poller_run = ctx; 320 321 *poller_run = true; 322 323 return -1; 324 } 325 326 static int 327 poller_run_times_done(void *ctx) 328 { 329 int *poller_run_times = ctx; 330 331 (*poller_run_times)++; 332 333 return -1; 334 } 335 336 static void 337 basic_poller(void) 338 { 339 struct spdk_poller *poller = NULL; 340 bool poller_run = false; 341 int poller_run_times = 0; 342 343 setup_test(); 344 345 set_thread(0); 346 reset_time(); 347 /* Register a poller with no-wait time and test execution */ 348 poller = spdk_poller_register(poller_run_done, &poller_run, 0); 349 CU_ASSERT(poller != NULL); 350 351 poll_threads(); 352 CU_ASSERT(poller_run == true); 353 354 spdk_poller_unregister(&poller); 355 CU_ASSERT(poller == NULL); 356 357 /* Register a poller with 1000us wait time and test single execution */ 358 poller_run = false; 359 poller = spdk_poller_register(poller_run_done, &poller_run, 1000); 360 CU_ASSERT(poller != NULL); 361 362 poll_threads(); 363 CU_ASSERT(poller_run == false); 364 365 increment_time(1000); 366 poll_threads(); 367 CU_ASSERT(poller_run == true); 368 369 reset_time(); 370 poller_run = false; 371 poll_threads(); 372 CU_ASSERT(poller_run == false); 373 374 increment_time(1000); 375 poll_threads(); 376 CU_ASSERT(poller_run == true); 377 378 spdk_poller_unregister(&poller); 379 CU_ASSERT(poller == NULL); 380 381 reset_time(); 382 /* Register a poller with 1000us wait time and test multiple execution */ 383 poller = spdk_poller_register(poller_run_times_done, &poller_run_times, 1000); 384 CU_ASSERT(poller != NULL); 385 386 poll_threads(); 387 CU_ASSERT(poller_run_times == 0); 388 389 increment_time(1000); 390 poll_threads(); 391 CU_ASSERT(poller_run_times == 1); 392 393 poller_run_times = 0; 394 increment_time(2000); 395 poll_threads(); 396 CU_ASSERT(poller_run_times == 2); 397 398 spdk_poller_unregister(&poller); 399 CU_ASSERT(poller == NULL); 400 401 teardown_test(); 402 } 403 404 static void 405 reset_done(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg) 406 { 407 bool *done = cb_arg; 408 409 CU_ASSERT(success == true); 410 *done = true; 411 spdk_bdev_free_io(bdev_io); 412 } 413 414 static void 415 put_channel_during_reset(void) 416 { 417 struct spdk_io_channel *io_ch; 418 bool done = false; 419 420 setup_test(); 421 422 set_thread(0); 423 io_ch = spdk_bdev_get_io_channel(g_desc); 424 CU_ASSERT(io_ch != NULL); 425 426 /* 427 * Start a reset, but then put the I/O channel before 428 * the deferred messages for the reset get a chance to 429 * execute. 430 */ 431 spdk_bdev_reset(g_desc, io_ch, reset_done, &done); 432 spdk_put_io_channel(io_ch); 433 poll_threads(); 434 stub_complete_io(g_bdev.io_target, 0); 435 436 teardown_test(); 437 } 438 439 static void 440 aborted_reset_done(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg) 441 { 442 enum spdk_bdev_io_status *status = cb_arg; 443 444 *status = success ? SPDK_BDEV_IO_STATUS_SUCCESS : SPDK_BDEV_IO_STATUS_FAILED; 445 spdk_bdev_free_io(bdev_io); 446 } 447 448 static void 449 aborted_reset(void) 450 { 451 struct spdk_io_channel *io_ch[2]; 452 enum spdk_bdev_io_status status1, status2; 453 454 setup_test(); 455 456 set_thread(0); 457 io_ch[0] = spdk_bdev_get_io_channel(g_desc); 458 CU_ASSERT(io_ch[0] != NULL); 459 spdk_bdev_reset(g_desc, io_ch[0], aborted_reset_done, &status1); 460 poll_threads(); 461 CU_ASSERT(g_bdev.bdev.reset_in_progress != NULL); 462 463 /* 464 * First reset has been submitted on ch0. Now submit a second 465 * reset on ch1 which will get queued since there is already a 466 * reset in progress. 467 */ 468 set_thread(1); 469 io_ch[1] = spdk_bdev_get_io_channel(g_desc); 470 CU_ASSERT(io_ch[1] != NULL); 471 spdk_bdev_reset(g_desc, io_ch[1], aborted_reset_done, &status2); 472 poll_threads(); 473 CU_ASSERT(g_bdev.bdev.reset_in_progress != NULL); 474 475 /* 476 * Now destroy ch1. This will abort the queued reset. Check that 477 * the second reset was completed with failed status. Also check 478 * that bdev->reset_in_progress != NULL, since the original reset 479 * has not been completed yet. This ensures that the bdev code is 480 * correctly noticing that the failed reset is *not* the one that 481 * had been submitted to the bdev module. 482 */ 483 set_thread(1); 484 spdk_put_io_channel(io_ch[1]); 485 poll_threads(); 486 CU_ASSERT(status2 == SPDK_BDEV_IO_STATUS_FAILED); 487 CU_ASSERT(g_bdev.bdev.reset_in_progress != NULL); 488 489 /* 490 * Now complete the first reset, verify that it completed with SUCCESS 491 * status and that bdev->reset_in_progress is also set back to NULL. 492 */ 493 set_thread(0); 494 spdk_put_io_channel(io_ch[0]); 495 stub_complete_io(g_bdev.io_target, 0); 496 poll_threads(); 497 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_SUCCESS); 498 CU_ASSERT(g_bdev.bdev.reset_in_progress == NULL); 499 500 teardown_test(); 501 } 502 503 static void 504 io_during_io_done(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg) 505 { 506 enum spdk_bdev_io_status *status = cb_arg; 507 508 *status = success ? SPDK_BDEV_IO_STATUS_SUCCESS : SPDK_BDEV_IO_STATUS_FAILED; 509 spdk_bdev_free_io(bdev_io); 510 } 511 512 static void 513 io_during_reset(void) 514 { 515 struct spdk_io_channel *io_ch[2]; 516 struct spdk_bdev_channel *bdev_ch[2]; 517 enum spdk_bdev_io_status status0, status1, status_reset; 518 int rc; 519 520 setup_test(); 521 522 /* 523 * First test normal case - submit an I/O on each of two channels (with no resets) 524 * and verify they complete successfully. 525 */ 526 set_thread(0); 527 io_ch[0] = spdk_bdev_get_io_channel(g_desc); 528 bdev_ch[0] = spdk_io_channel_get_ctx(io_ch[0]); 529 CU_ASSERT(bdev_ch[0]->flags == 0); 530 status0 = SPDK_BDEV_IO_STATUS_PENDING; 531 rc = spdk_bdev_read_blocks(g_desc, io_ch[0], NULL, 0, 1, io_during_io_done, &status0); 532 CU_ASSERT(rc == 0); 533 534 set_thread(1); 535 io_ch[1] = spdk_bdev_get_io_channel(g_desc); 536 bdev_ch[1] = spdk_io_channel_get_ctx(io_ch[1]); 537 CU_ASSERT(bdev_ch[1]->flags == 0); 538 status1 = SPDK_BDEV_IO_STATUS_PENDING; 539 rc = spdk_bdev_read_blocks(g_desc, io_ch[1], NULL, 0, 1, io_during_io_done, &status1); 540 CU_ASSERT(rc == 0); 541 542 poll_threads(); 543 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_PENDING); 544 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_PENDING); 545 546 set_thread(0); 547 stub_complete_io(g_bdev.io_target, 0); 548 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_SUCCESS); 549 550 set_thread(1); 551 stub_complete_io(g_bdev.io_target, 0); 552 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_SUCCESS); 553 554 /* 555 * Now submit a reset, and leave it pending while we submit I/O on two different 556 * channels. These I/O should be failed by the bdev layer since the reset is in 557 * progress. 558 */ 559 set_thread(0); 560 status_reset = SPDK_BDEV_IO_STATUS_PENDING; 561 rc = spdk_bdev_reset(g_desc, io_ch[0], io_during_io_done, &status_reset); 562 CU_ASSERT(rc == 0); 563 564 CU_ASSERT(bdev_ch[0]->flags == 0); 565 CU_ASSERT(bdev_ch[1]->flags == 0); 566 poll_threads(); 567 CU_ASSERT(bdev_ch[0]->flags == BDEV_CH_RESET_IN_PROGRESS); 568 CU_ASSERT(bdev_ch[1]->flags == BDEV_CH_RESET_IN_PROGRESS); 569 570 set_thread(0); 571 status0 = SPDK_BDEV_IO_STATUS_PENDING; 572 rc = spdk_bdev_read_blocks(g_desc, io_ch[0], NULL, 0, 1, io_during_io_done, &status0); 573 CU_ASSERT(rc == 0); 574 575 set_thread(1); 576 status1 = SPDK_BDEV_IO_STATUS_PENDING; 577 rc = spdk_bdev_read_blocks(g_desc, io_ch[1], NULL, 0, 1, io_during_io_done, &status1); 578 CU_ASSERT(rc == 0); 579 580 /* 581 * A reset is in progress so these read I/O should complete with failure. Note that we 582 * need to poll_threads() since I/O completed inline have their completion deferred. 583 */ 584 poll_threads(); 585 CU_ASSERT(status_reset == SPDK_BDEV_IO_STATUS_PENDING); 586 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_FAILED); 587 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_FAILED); 588 589 /* 590 * Complete the reset 591 */ 592 set_thread(0); 593 stub_complete_io(g_bdev.io_target, 0); 594 595 /* 596 * Only poll thread 0. We should not get a completion. 597 */ 598 poll_thread(0); 599 CU_ASSERT(status_reset == SPDK_BDEV_IO_STATUS_PENDING); 600 601 /* 602 * Poll both thread 0 and 1 so the messages can propagate and we 603 * get a completion. 604 */ 605 poll_threads(); 606 CU_ASSERT(status_reset == SPDK_BDEV_IO_STATUS_SUCCESS); 607 608 spdk_put_io_channel(io_ch[0]); 609 set_thread(1); 610 spdk_put_io_channel(io_ch[1]); 611 poll_threads(); 612 613 teardown_test(); 614 } 615 616 static void 617 basic_qos(void) 618 { 619 struct spdk_io_channel *io_ch[2]; 620 struct spdk_bdev *bdev; 621 enum spdk_bdev_io_status status; 622 int rc; 623 624 setup_test(); 625 626 /* Enable QoS */ 627 bdev = &g_bdev.bdev; 628 bdev->ios_per_sec = 2000; /* 2 I/O per millisecond */ 629 630 g_get_io_channel = true; 631 632 set_thread(0); 633 io_ch[0] = spdk_bdev_get_io_channel(g_desc); 634 635 set_thread(1); 636 io_ch[1] = spdk_bdev_get_io_channel(g_desc); 637 638 /* 639 * Send an I/O on thread 0, which is where the QoS thread is running. 640 */ 641 set_thread(0); 642 status = SPDK_BDEV_IO_STATUS_PENDING; 643 rc = spdk_bdev_read_blocks(g_desc, io_ch[0], NULL, 0, 1, io_during_io_done, &status); 644 CU_ASSERT(rc == 0); 645 CU_ASSERT(status == SPDK_BDEV_IO_STATUS_PENDING); 646 poll_threads(); 647 stub_complete_io(g_bdev.io_target, 0); 648 poll_threads(); 649 CU_ASSERT(status == SPDK_BDEV_IO_STATUS_SUCCESS); 650 651 /* Send an I/O on thread 1. The QoS thread is not running here. */ 652 status = SPDK_BDEV_IO_STATUS_PENDING; 653 set_thread(1); 654 rc = spdk_bdev_read_blocks(g_desc, io_ch[1], NULL, 0, 1, io_during_io_done, &status); 655 CU_ASSERT(rc == 0); 656 CU_ASSERT(status == SPDK_BDEV_IO_STATUS_PENDING); 657 poll_threads(); 658 /* Complete I/O on thread 1. This should not complete the I/O we submitted */ 659 stub_complete_io(g_bdev.io_target, 0); 660 poll_threads(); 661 CU_ASSERT(status == SPDK_BDEV_IO_STATUS_PENDING); 662 /* Now complete I/O on thread 0 */ 663 set_thread(0); 664 poll_threads(); 665 stub_complete_io(g_bdev.io_target, 0); 666 poll_threads(); 667 CU_ASSERT(status == SPDK_BDEV_IO_STATUS_SUCCESS); 668 669 /* Tear down the channels */ 670 set_thread(0); 671 spdk_put_io_channel(io_ch[0]); 672 set_thread(1); 673 spdk_put_io_channel(io_ch[1]); 674 poll_threads(); 675 set_thread(0); 676 677 /* Close the descriptor, which should stop the qos channel */ 678 spdk_bdev_close(g_desc); 679 CU_ASSERT(bdev->qos_channel == NULL); 680 681 spdk_bdev_open(bdev, true, NULL, NULL, &g_desc); 682 683 /* Create the channels in reverse order. */ 684 set_thread(1); 685 io_ch[1] = spdk_bdev_get_io_channel(g_desc); 686 687 set_thread(0); 688 io_ch[0] = spdk_bdev_get_io_channel(g_desc); 689 690 /* Confirm that the qos tracking was re-enabled */ 691 CU_ASSERT(bdev->qos_channel != NULL); 692 693 /* Tear down the channels */ 694 set_thread(0); 695 spdk_put_io_channel(io_ch[0]); 696 set_thread(1); 697 spdk_put_io_channel(io_ch[1]); 698 poll_threads(); 699 700 set_thread(0); 701 702 teardown_test(); 703 } 704 705 static void 706 io_during_qos_queue(void) 707 { 708 struct spdk_io_channel *io_ch[2]; 709 struct spdk_bdev *bdev; 710 enum spdk_bdev_io_status status0, status1; 711 int rc; 712 713 setup_test(); 714 reset_time(); 715 716 /* Enable QoS */ 717 bdev = &g_bdev.bdev; 718 bdev->ios_per_sec = 1000; /* 1000 I/O per second, or 1 per millisecond */ 719 720 g_get_io_channel = true; 721 722 /* Create channels */ 723 set_thread(0); 724 io_ch[0] = spdk_bdev_get_io_channel(g_desc); 725 726 set_thread(1); 727 io_ch[1] = spdk_bdev_get_io_channel(g_desc); 728 729 /* Send two I/O */ 730 status1 = SPDK_BDEV_IO_STATUS_PENDING; 731 rc = spdk_bdev_read_blocks(g_desc, io_ch[1], NULL, 0, 1, io_during_io_done, &status1); 732 CU_ASSERT(rc == 0); 733 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_PENDING); 734 set_thread(0); 735 status0 = SPDK_BDEV_IO_STATUS_PENDING; 736 rc = spdk_bdev_read_blocks(g_desc, io_ch[0], NULL, 0, 1, io_during_io_done, &status0); 737 CU_ASSERT(rc == 0); 738 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_PENDING); 739 740 /* Complete any I/O that arrived at the disk */ 741 poll_threads(); 742 set_thread(1); 743 stub_complete_io(g_bdev.io_target, 0); 744 set_thread(0); 745 stub_complete_io(g_bdev.io_target, 0); 746 poll_threads(); 747 748 /* Only one of the I/O should complete. (logical XOR) */ 749 if (status0 == SPDK_BDEV_IO_STATUS_SUCCESS) { 750 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_PENDING); 751 } else { 752 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_SUCCESS); 753 } 754 755 /* Advance in time by a millisecond */ 756 increment_time(1000); 757 758 /* Complete more I/O */ 759 poll_threads(); 760 set_thread(1); 761 stub_complete_io(g_bdev.io_target, 0); 762 set_thread(0); 763 stub_complete_io(g_bdev.io_target, 0); 764 poll_threads(); 765 766 /* Now the second I/O should be done */ 767 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_SUCCESS); 768 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_SUCCESS); 769 770 /* Tear down the channels */ 771 set_thread(1); 772 spdk_put_io_channel(io_ch[1]); 773 set_thread(0); 774 spdk_put_io_channel(io_ch[0]); 775 poll_threads(); 776 777 teardown_test(); 778 } 779 780 static void 781 io_during_qos_reset(void) 782 { 783 struct spdk_io_channel *io_ch[2]; 784 struct spdk_bdev *bdev; 785 enum spdk_bdev_io_status status0, status1, reset_status; 786 int rc; 787 788 setup_test(); 789 reset_time(); 790 791 /* Enable QoS */ 792 bdev = &g_bdev.bdev; 793 bdev->ios_per_sec = 1000; /* 1000 I/O per second, or 1 per millisecond */ 794 795 g_get_io_channel = true; 796 797 /* Create channels */ 798 set_thread(0); 799 io_ch[0] = spdk_bdev_get_io_channel(g_desc); 800 801 set_thread(1); 802 io_ch[1] = spdk_bdev_get_io_channel(g_desc); 803 804 /* Send two I/O. One of these gets queued by QoS. The other is sitting at the disk. */ 805 status1 = SPDK_BDEV_IO_STATUS_PENDING; 806 rc = spdk_bdev_read_blocks(g_desc, io_ch[1], NULL, 0, 1, io_during_io_done, &status1); 807 CU_ASSERT(rc == 0); 808 set_thread(0); 809 status0 = SPDK_BDEV_IO_STATUS_PENDING; 810 rc = spdk_bdev_read_blocks(g_desc, io_ch[0], NULL, 0, 1, io_during_io_done, &status0); 811 CU_ASSERT(rc == 0); 812 813 poll_threads(); 814 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_PENDING); 815 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_PENDING); 816 817 /* Reset the bdev. */ 818 reset_status = SPDK_BDEV_IO_STATUS_PENDING; 819 rc = spdk_bdev_reset(g_desc, io_ch[0], io_during_io_done, &reset_status); 820 CU_ASSERT(rc == 0); 821 822 /* Complete any I/O that arrived at the disk */ 823 poll_threads(); 824 set_thread(1); 825 stub_complete_io(g_bdev.io_target, 0); 826 set_thread(0); 827 stub_complete_io(g_bdev.io_target, 0); 828 poll_threads(); 829 830 CU_ASSERT(reset_status == SPDK_BDEV_IO_STATUS_SUCCESS); 831 CU_ASSERT(status0 == SPDK_BDEV_IO_STATUS_FAILED); 832 CU_ASSERT(status1 == SPDK_BDEV_IO_STATUS_FAILED); 833 834 /* Tear down the channels */ 835 set_thread(1); 836 spdk_put_io_channel(io_ch[1]); 837 set_thread(0); 838 spdk_put_io_channel(io_ch[0]); 839 poll_threads(); 840 841 teardown_test(); 842 } 843 844 static void 845 enomem_done(struct spdk_bdev_io *bdev_io, bool success, void *cb_arg) 846 { 847 enum spdk_bdev_io_status *status = cb_arg; 848 849 *status = success ? SPDK_BDEV_IO_STATUS_SUCCESS : SPDK_BDEV_IO_STATUS_FAILED; 850 spdk_bdev_free_io(bdev_io); 851 } 852 853 static void 854 enomem(void) 855 { 856 struct spdk_io_channel *io_ch; 857 struct spdk_bdev_channel *bdev_ch; 858 struct spdk_bdev_module_channel *module_ch; 859 struct ut_bdev_channel *ut_ch; 860 const uint32_t IO_ARRAY_SIZE = 64; 861 const uint32_t AVAIL = 20; 862 enum spdk_bdev_io_status status[IO_ARRAY_SIZE], status_reset; 863 uint32_t nomem_cnt, i; 864 struct spdk_bdev_io *first_io; 865 int rc; 866 867 setup_test(); 868 869 set_thread(0); 870 io_ch = spdk_bdev_get_io_channel(g_desc); 871 bdev_ch = spdk_io_channel_get_ctx(io_ch); 872 module_ch = bdev_ch->module_ch; 873 ut_ch = spdk_io_channel_get_ctx(bdev_ch->channel); 874 ut_ch->avail_cnt = AVAIL; 875 876 /* First submit a number of IOs equal to what the channel can support. */ 877 for (i = 0; i < AVAIL; i++) { 878 status[i] = SPDK_BDEV_IO_STATUS_PENDING; 879 rc = spdk_bdev_read_blocks(g_desc, io_ch, NULL, 0, 1, enomem_done, &status[i]); 880 CU_ASSERT(rc == 0); 881 } 882 CU_ASSERT(TAILQ_EMPTY(&module_ch->nomem_io)); 883 884 /* 885 * Next, submit one additional I/O. This one should fail with ENOMEM and then go onto 886 * the enomem_io list. 887 */ 888 status[AVAIL] = SPDK_BDEV_IO_STATUS_PENDING; 889 rc = spdk_bdev_read_blocks(g_desc, io_ch, NULL, 0, 1, enomem_done, &status[AVAIL]); 890 CU_ASSERT(rc == 0); 891 SPDK_CU_ASSERT_FATAL(!TAILQ_EMPTY(&module_ch->nomem_io)); 892 first_io = TAILQ_FIRST(&module_ch->nomem_io); 893 894 /* 895 * Now submit a bunch more I/O. These should all fail with ENOMEM and get queued behind 896 * the first_io above. 897 */ 898 for (i = AVAIL + 1; i < IO_ARRAY_SIZE; i++) { 899 status[i] = SPDK_BDEV_IO_STATUS_PENDING; 900 rc = spdk_bdev_read_blocks(g_desc, io_ch, NULL, 0, 1, enomem_done, &status[i]); 901 CU_ASSERT(rc == 0); 902 } 903 904 /* Assert that first_io is still at the head of the list. */ 905 CU_ASSERT(TAILQ_FIRST(&module_ch->nomem_io) == first_io); 906 CU_ASSERT(bdev_io_tailq_cnt(&module_ch->nomem_io) == (IO_ARRAY_SIZE - AVAIL)); 907 nomem_cnt = bdev_io_tailq_cnt(&module_ch->nomem_io); 908 CU_ASSERT(module_ch->nomem_threshold == (AVAIL - NOMEM_THRESHOLD_COUNT)); 909 910 /* 911 * Complete 1 I/O only. The key check here is bdev_io_tailq_cnt - this should not have 912 * changed since completing just 1 I/O should not trigger retrying the queued nomem_io 913 * list. 914 */ 915 stub_complete_io(g_bdev.io_target, 1); 916 CU_ASSERT(bdev_io_tailq_cnt(&module_ch->nomem_io) == nomem_cnt); 917 918 /* 919 * Complete enough I/O to hit the nomem_theshold. This should trigger retrying nomem_io, 920 * and we should see I/O get resubmitted to the test bdev module. 921 */ 922 stub_complete_io(g_bdev.io_target, NOMEM_THRESHOLD_COUNT - 1); 923 CU_ASSERT(bdev_io_tailq_cnt(&module_ch->nomem_io) < nomem_cnt); 924 nomem_cnt = bdev_io_tailq_cnt(&module_ch->nomem_io); 925 926 /* Complete 1 I/O only. This should not trigger retrying the queued nomem_io. */ 927 stub_complete_io(g_bdev.io_target, 1); 928 CU_ASSERT(bdev_io_tailq_cnt(&module_ch->nomem_io) == nomem_cnt); 929 930 /* 931 * Send a reset and confirm that all I/O are completed, including the ones that 932 * were queued on the nomem_io list. 933 */ 934 status_reset = SPDK_BDEV_IO_STATUS_PENDING; 935 rc = spdk_bdev_reset(g_desc, io_ch, enomem_done, &status_reset); 936 poll_threads(); 937 CU_ASSERT(rc == 0); 938 /* This will complete the reset. */ 939 stub_complete_io(g_bdev.io_target, 0); 940 941 CU_ASSERT(bdev_io_tailq_cnt(&module_ch->nomem_io) == 0); 942 CU_ASSERT(module_ch->io_outstanding == 0); 943 944 spdk_put_io_channel(io_ch); 945 poll_threads(); 946 teardown_test(); 947 } 948 949 static void 950 enomem_multi_bdev(void) 951 { 952 struct spdk_io_channel *io_ch; 953 struct spdk_bdev_channel *bdev_ch; 954 struct spdk_bdev_module_channel *module_ch; 955 struct ut_bdev_channel *ut_ch; 956 const uint32_t IO_ARRAY_SIZE = 64; 957 const uint32_t AVAIL = 20; 958 enum spdk_bdev_io_status status[IO_ARRAY_SIZE]; 959 uint32_t i; 960 struct ut_bdev *second_bdev; 961 struct spdk_bdev_desc *second_desc; 962 struct spdk_bdev_channel *second_bdev_ch; 963 struct spdk_io_channel *second_ch; 964 int rc; 965 966 setup_test(); 967 968 /* Register second bdev with the same io_target */ 969 second_bdev = calloc(1, sizeof(*second_bdev)); 970 SPDK_CU_ASSERT_FATAL(second_bdev != NULL); 971 register_bdev(second_bdev, "ut_bdev2", g_bdev.io_target); 972 spdk_bdev_open(&second_bdev->bdev, true, NULL, NULL, &second_desc); 973 974 set_thread(0); 975 io_ch = spdk_bdev_get_io_channel(g_desc); 976 bdev_ch = spdk_io_channel_get_ctx(io_ch); 977 module_ch = bdev_ch->module_ch; 978 ut_ch = spdk_io_channel_get_ctx(bdev_ch->channel); 979 ut_ch->avail_cnt = AVAIL; 980 981 second_ch = spdk_bdev_get_io_channel(second_desc); 982 second_bdev_ch = spdk_io_channel_get_ctx(second_ch); 983 SPDK_CU_ASSERT_FATAL(module_ch == second_bdev_ch->module_ch); 984 985 /* Saturate io_target through bdev A. */ 986 for (i = 0; i < AVAIL; i++) { 987 status[i] = SPDK_BDEV_IO_STATUS_PENDING; 988 rc = spdk_bdev_read_blocks(g_desc, io_ch, NULL, 0, 1, enomem_done, &status[i]); 989 CU_ASSERT(rc == 0); 990 } 991 CU_ASSERT(TAILQ_EMPTY(&module_ch->nomem_io)); 992 993 /* 994 * Now submit I/O through the second bdev. This should fail with ENOMEM 995 * and then go onto the nomem_io list. 996 */ 997 status[AVAIL] = SPDK_BDEV_IO_STATUS_PENDING; 998 rc = spdk_bdev_read_blocks(second_desc, second_ch, NULL, 0, 1, enomem_done, &status[AVAIL]); 999 CU_ASSERT(rc == 0); 1000 SPDK_CU_ASSERT_FATAL(!TAILQ_EMPTY(&module_ch->nomem_io)); 1001 1002 /* Complete first bdev's I/O. This should retry sending second bdev's nomem_io */ 1003 stub_complete_io(g_bdev.io_target, AVAIL); 1004 1005 SPDK_CU_ASSERT_FATAL(TAILQ_EMPTY(&module_ch->nomem_io)); 1006 CU_ASSERT(module_ch->io_outstanding == 1); 1007 1008 /* Now complete our retried I/O */ 1009 stub_complete_io(g_bdev.io_target, 1); 1010 SPDK_CU_ASSERT_FATAL(module_ch->io_outstanding == 0); 1011 1012 spdk_put_io_channel(io_ch); 1013 spdk_put_io_channel(second_ch); 1014 spdk_bdev_close(second_desc); 1015 unregister_bdev(second_bdev); 1016 poll_threads(); 1017 free(second_bdev); 1018 teardown_test(); 1019 } 1020 1021 int 1022 main(int argc, char **argv) 1023 { 1024 CU_pSuite suite = NULL; 1025 unsigned int num_failures; 1026 1027 if (CU_initialize_registry() != CUE_SUCCESS) { 1028 return CU_get_error(); 1029 } 1030 1031 suite = CU_add_suite("bdev", NULL, NULL); 1032 if (suite == NULL) { 1033 CU_cleanup_registry(); 1034 return CU_get_error(); 1035 } 1036 1037 if ( 1038 CU_add_test(suite, "basic", basic) == NULL || 1039 CU_add_test(suite, "basic_poller", basic_poller) == NULL || 1040 CU_add_test(suite, "basic_qos", basic_qos) == NULL || 1041 CU_add_test(suite, "put_channel_during_reset", put_channel_during_reset) == NULL || 1042 CU_add_test(suite, "aborted_reset", aborted_reset) == NULL || 1043 CU_add_test(suite, "io_during_reset", io_during_reset) == NULL || 1044 CU_add_test(suite, "io_during_qos_queue", io_during_qos_queue) == NULL || 1045 CU_add_test(suite, "io_during_qos_reset", io_during_qos_reset) == NULL || 1046 CU_add_test(suite, "enomem", enomem) == NULL || 1047 CU_add_test(suite, "enomem_multi_bdev", enomem_multi_bdev) == NULL 1048 ) { 1049 CU_cleanup_registry(); 1050 return CU_get_error(); 1051 } 1052 1053 CU_basic_set_mode(CU_BRM_VERBOSE); 1054 CU_basic_run_tests(); 1055 num_failures = CU_get_number_of_failures(); 1056 CU_cleanup_registry(); 1057 return num_failures; 1058 } 1059