4 * Copyright (c) Intel Corporation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
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
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.
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.
34 #ifndef SPDK_BDEV_NVME_H
35 #define SPDK_BDEV_NVME_H
37 #include "spdk/stdinc.h"
39 #include "spdk/queue.h"
40 #include "spdk/nvme.h"
41 #include "spdk/bdev_module.h"
43 enum spdk_bdev_timeout_action
{
44 SPDK_BDEV_NVME_TIMEOUT_ACTION_NONE
= 0,
45 SPDK_BDEV_NVME_TIMEOUT_ACTION_RESET
,
46 SPDK_BDEV_NVME_TIMEOUT_ACTION_ABORT
,
49 struct spdk_bdev_nvme_opts
{
50 enum spdk_bdev_timeout_action action_on_timeout
;
53 uint64_t nvme_adminq_poll_period_us
;
54 uint64_t nvme_ioq_poll_period_us
;
57 typedef void (*spdk_bdev_create_nvme_fn
)(void *ctx
, int rc
);
58 struct spdk_nvme_qpair
*spdk_bdev_nvme_get_io_qpair(struct spdk_io_channel
*ctrlr_io_ch
);
59 void spdk_bdev_nvme_get_opts(struct spdk_bdev_nvme_opts
*opts
);
60 int spdk_bdev_nvme_set_opts(const struct spdk_bdev_nvme_opts
*opts
);
61 int spdk_bdev_nvme_set_hotplug(bool enabled
, uint64_t period_us
, spdk_msg_fn cb
, void *cb_ctx
);
63 int spdk_bdev_nvme_create(struct spdk_nvme_transport_id
*trid
,
64 struct spdk_nvme_host_id
*hostid
,
65 const char *base_name
,
66 const char **names
, size_t *count
,
69 spdk_bdev_create_nvme_fn cb_fn
,
71 struct spdk_nvme_ctrlr
*spdk_bdev_nvme_get_ctrlr(struct spdk_bdev
*bdev
);
74 * Delete NVMe controller with all bdevs on top of it.
75 * Requires to pass name of NVMe controller.
77 * \param name NVMe controller name
78 * \return zero on success, -EINVAL on wrong parameters or -ENODEV if controller is not found
80 int spdk_bdev_nvme_delete(const char *name
);
82 #endif /* SPDK_BDEV_NVME_H */