/*- * BSD LICENSE * * Copyright (c) Intel Corporation. * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in * the documentation and/or other materials provided with the * distribution. * * Neither the name of Intel Corporation nor the names of its * contributors may be used to endorse or promote products derived * from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #include "spdk/stdinc.h" #include "spdk_cunit.h" #include "common/lib/test_env.c" #include "nvme/nvme_pcie.c" struct spdk_log_flag SPDK_LOG_NVME = { .name = "nvme", .enabled = false, }; struct nvme_driver *g_spdk_nvme_driver = NULL; bool g_device_is_enumerated = false; void nvme_ctrlr_fail(struct spdk_nvme_ctrlr *ctrlr, bool hot_remove) { CU_ASSERT(ctrlr != NULL); if (hot_remove) { ctrlr->is_removed = true; } ctrlr->is_failed = true; } struct spdk_uevent_entry { struct spdk_uevent uevent; STAILQ_ENTRY(spdk_uevent_entry) link; }; static STAILQ_HEAD(, spdk_uevent_entry) g_uevents = STAILQ_HEAD_INITIALIZER(g_uevents); int spdk_get_uevent(int fd, struct spdk_uevent *uevent) { struct spdk_uevent_entry *entry; if (STAILQ_EMPTY(&g_uevents)) { return 0; } entry = STAILQ_FIRST(&g_uevents); STAILQ_REMOVE_HEAD(&g_uevents, link); *uevent = entry->uevent; return 1; } int spdk_pci_enumerate(struct spdk_pci_driver *driver, spdk_pci_enum_cb enum_cb, void *enum_ctx) { g_device_is_enumerated = true; return 0; } struct spdk_pci_addr spdk_pci_device_get_addr(struct spdk_pci_device *dev) { abort(); } int nvme_ctrlr_add_process(struct spdk_nvme_ctrlr *ctrlr, void *devhandle) { abort(); } int nvme_ctrlr_probe(const struct spdk_nvme_transport_id *trid, struct spdk_nvme_probe_ctx *probe_ctx, void *devhandle) { abort(); } struct spdk_nvme_ctrlr_process * spdk_nvme_ctrlr_get_current_process(struct spdk_nvme_ctrlr *ctrlr) { return (struct spdk_nvme_ctrlr_process *)0x1; } DEFINE_STUB(spdk_pci_device_is_removed, bool, (struct spdk_pci_device *dev), false); DEFINE_STUB(spdk_nvme_get_ctrlr_by_trid_unsafe, struct spdk_nvme_ctrlr *, (const struct spdk_nvme_transport_id *trid), NULL); union spdk_nvme_csts_register spdk_nvme_ctrlr_get_regs_csts(struct spdk_nvme_ctrlr *ctrlr) { union spdk_nvme_csts_register csts = {}; return csts; } static void prp_list_prep(struct nvme_tracker *tr, struct nvme_request *req, uint32_t *prp_index) { memset(req, 0, sizeof(*req)); memset(tr, 0, sizeof(*tr)); tr->req = req; tr->prp_sgl_bus_addr = 0xDEADBEEF; *prp_index = 0; } static void test_prp_list_append(void) { struct nvme_request req; struct nvme_tracker tr; uint32_t prp_index; /* Non-DWORD-aligned buffer (invalid) */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100001, 0x1000, 0x1000) == -EFAULT); /* 512-byte buffer, 4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, 0x200, 0x1000) == 0); CU_ASSERT(prp_index == 1); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100000); /* 512-byte buffer, non-4K-aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x108000, 0x200, 0x1000) == 0); CU_ASSERT(prp_index == 1); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x108000); /* 4K buffer, 4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 1); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100000); /* 4K buffer, non-4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 2); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100800); CU_ASSERT(req.cmd.dptr.prp.prp2 == 0x101000); /* 8K buffer, 4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, 0x2000, 0x1000) == 0); CU_ASSERT(prp_index == 2); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100000); CU_ASSERT(req.cmd.dptr.prp.prp2 == 0x101000); /* 8K buffer, non-4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, 0x2000, 0x1000) == 0); CU_ASSERT(prp_index == 3); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100800); CU_ASSERT(req.cmd.dptr.prp.prp2 == tr.prp_sgl_bus_addr); CU_ASSERT(tr.u.prp[0] == 0x101000); CU_ASSERT(tr.u.prp[1] == 0x102000); /* 12K buffer, 4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, 0x3000, 0x1000) == 0); CU_ASSERT(prp_index == 3); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100000); CU_ASSERT(req.cmd.dptr.prp.prp2 == tr.prp_sgl_bus_addr); CU_ASSERT(tr.u.prp[0] == 0x101000); CU_ASSERT(tr.u.prp[1] == 0x102000); /* 12K buffer, non-4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, 0x3000, 0x1000) == 0); CU_ASSERT(prp_index == 4); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100800); CU_ASSERT(req.cmd.dptr.prp.prp2 == tr.prp_sgl_bus_addr); CU_ASSERT(tr.u.prp[0] == 0x101000); CU_ASSERT(tr.u.prp[1] == 0x102000); CU_ASSERT(tr.u.prp[2] == 0x103000); /* Two 4K buffers, both 4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 1); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x900000, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 2); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100000); CU_ASSERT(req.cmd.dptr.prp.prp2 == 0x900000); /* Two 4K buffers, first non-4K aligned, second 4K aligned */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 2); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x900000, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 3); CU_ASSERT(req.cmd.dptr.prp.prp1 == 0x100800); CU_ASSERT(req.cmd.dptr.prp.prp2 == tr.prp_sgl_bus_addr); CU_ASSERT(tr.u.prp[0] == 0x101000); CU_ASSERT(tr.u.prp[1] == 0x900000); /* Two 4K buffers, both non-4K aligned (invalid) */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == 2); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x900800, 0x1000, 0x1000) == -EFAULT); CU_ASSERT(prp_index == 2); /* 4K buffer, 4K aligned, but vtophys fails */ MOCK_SET(spdk_vtophys, SPDK_VTOPHYS_ERROR); prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, 0x1000, 0x1000) == -EFAULT); MOCK_CLEAR(spdk_vtophys); /* Largest aligned buffer that can be described in NVME_MAX_PRP_LIST_ENTRIES (plus PRP1) */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, (NVME_MAX_PRP_LIST_ENTRIES + 1) * 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == NVME_MAX_PRP_LIST_ENTRIES + 1); /* Largest non-4K-aligned buffer that can be described in NVME_MAX_PRP_LIST_ENTRIES (plus PRP1) */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, NVME_MAX_PRP_LIST_ENTRIES * 0x1000, 0x1000) == 0); CU_ASSERT(prp_index == NVME_MAX_PRP_LIST_ENTRIES + 1); /* Buffer too large to be described in NVME_MAX_PRP_LIST_ENTRIES */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100000, (NVME_MAX_PRP_LIST_ENTRIES + 2) * 0x1000, 0x1000) == -EFAULT); /* Non-4K-aligned buffer too large to be described in NVME_MAX_PRP_LIST_ENTRIES */ prp_list_prep(&tr, &req, &prp_index); CU_ASSERT(nvme_pcie_prp_list_append(&tr, &prp_index, (void *)0x100800, (NVME_MAX_PRP_LIST_ENTRIES + 1) * 0x1000, 0x1000) == -EFAULT); } static void test_nvme_pcie_hotplug_monitor(void) { struct spdk_nvme_ctrlr ctrlr = {}; struct spdk_uevent_entry entry = {}; struct nvme_driver driver; pthread_mutexattr_t attr; struct spdk_nvme_probe_ctx test_nvme_probe_ctx = {}; /* Initiate variables and ctrlr */ driver.initialized = true; CU_ASSERT(pthread_mutexattr_init(&attr) == 0); CU_ASSERT(pthread_mutex_init(&driver.lock, &attr) == 0); TAILQ_INIT(&driver.shared_attached_ctrlrs); g_spdk_nvme_driver = &driver; /* Case 1: SPDK_NVME_UEVENT_ADD/ NVME_VFIO */ entry.uevent.subsystem = SPDK_NVME_UEVENT_SUBSYSTEM_VFIO; entry.uevent.action = SPDK_NVME_UEVENT_ADD; snprintf(entry.uevent.traddr, sizeof(entry.uevent.traddr), "0000:05:00.0"); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); STAILQ_INSERT_TAIL(&g_uevents, &entry, link); _nvme_pcie_hotplug_monitor(&test_nvme_probe_ctx); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); CU_ASSERT(g_device_is_enumerated == true); g_device_is_enumerated = false; /* Case 2: SPDK_NVME_UEVENT_ADD/ NVME_UIO */ entry.uevent.subsystem = SPDK_NVME_UEVENT_SUBSYSTEM_UIO; entry.uevent.action = SPDK_NVME_UEVENT_ADD; snprintf(entry.uevent.traddr, sizeof(entry.uevent.traddr), "0000:05:00.0"); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); STAILQ_INSERT_TAIL(&g_uevents, &entry, link); _nvme_pcie_hotplug_monitor(&test_nvme_probe_ctx); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); CU_ASSERT(g_device_is_enumerated == true); g_device_is_enumerated = false; /* Case 3: SPDK_NVME_UEVENT_REMOVE/ NVME_UIO */ entry.uevent.subsystem = SPDK_NVME_UEVENT_SUBSYSTEM_UIO; entry.uevent.action = SPDK_NVME_UEVENT_REMOVE; snprintf(entry.uevent.traddr, sizeof(entry.uevent.traddr), "0000:05:00.0"); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); STAILQ_INSERT_TAIL(&g_uevents, &entry, link); MOCK_SET(spdk_nvme_get_ctrlr_by_trid_unsafe, &ctrlr); _nvme_pcie_hotplug_monitor(&test_nvme_probe_ctx); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); CU_ASSERT(ctrlr.is_failed == true); ctrlr.is_failed = false; MOCK_CLEAR(spdk_nvme_get_ctrlr_by_trid_unsafe); /* Case 4: SPDK_NVME_UEVENT_REMOVE/ NVME_VFIO */ entry.uevent.subsystem = SPDK_NVME_UEVENT_SUBSYSTEM_VFIO; entry.uevent.action = SPDK_NVME_UEVENT_REMOVE; snprintf(entry.uevent.traddr, sizeof(entry.uevent.traddr), "0000:05:00.0"); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); STAILQ_INSERT_TAIL(&g_uevents, &entry, link); MOCK_SET(spdk_nvme_get_ctrlr_by_trid_unsafe, &ctrlr); _nvme_pcie_hotplug_monitor(&test_nvme_probe_ctx); CU_ASSERT(STAILQ_EMPTY(&g_uevents)); CU_ASSERT(ctrlr.is_failed == true); ctrlr.is_failed = false; MOCK_CLEAR(spdk_nvme_get_ctrlr_by_trid_unsafe); /* Case 5: Removed device detected in another process */ ctrlr.trid.trtype = SPDK_NVME_TRANSPORT_PCIE; snprintf(ctrlr.trid.traddr, sizeof(ctrlr.trid.traddr), "0000:02:00.0"); ctrlr.remove_cb = NULL; ctrlr.is_failed = false; ctrlr.is_removed = false; TAILQ_INSERT_TAIL(&g_spdk_nvme_driver->shared_attached_ctrlrs, &ctrlr, tailq); MOCK_SET(spdk_pci_device_is_removed, false); _nvme_pcie_hotplug_monitor(&test_nvme_probe_ctx); CU_ASSERT(ctrlr.is_failed == false); MOCK_SET(spdk_pci_device_is_removed, true); _nvme_pcie_hotplug_monitor(&test_nvme_probe_ctx); CU_ASSERT(ctrlr.is_failed == true); pthread_mutex_destroy(&driver.lock); pthread_mutexattr_destroy(&attr); g_spdk_nvme_driver = NULL; } static void test_shadow_doorbell_update(void) { bool ret; /* nvme_pcie_qpair_need_event(uint16_t event_idx, uint16_t new_idx, uint16_t old) */ ret = nvme_pcie_qpair_need_event(10, 15, 14); CU_ASSERT(ret == false); ret = nvme_pcie_qpair_need_event(14, 15, 14); CU_ASSERT(ret == true); } int main(int argc, char **argv) { CU_pSuite suite = NULL; unsigned int num_failures; if (CU_initialize_registry() != CUE_SUCCESS) { return CU_get_error(); } suite = CU_add_suite("nvme_pcie", NULL, NULL); if (suite == NULL) { CU_cleanup_registry(); return CU_get_error(); } if (CU_add_test(suite, "prp_list_append", test_prp_list_append) == NULL || CU_add_test(suite, "nvme_pcie_hotplug_monitor", test_nvme_pcie_hotplug_monitor) == NULL || CU_add_test(suite, "shadow_doorbell_update", test_shadow_doorbell_update) == NULL) { CU_cleanup_registry(); return CU_get_error(); } CU_basic_set_mode(CU_BRM_VERBOSE); CU_basic_run_tests(); num_failures = CU_get_number_of_failures(); CU_cleanup_registry(); return num_failures; }