nvme.h File Reference

Nvme block device abstraction layer. More...

Data Structures
struct	spdk_bdev_nvme_ctrlr_opts

Typedefs
typedef void(*	spdk_bdev_nvme_create_cb) (void *ctx, size_t bdev_count, int rc)
typedef void(*	spdk_bdev_nvme_set_multipath_policy_cb) (void *cb_arg, int rc)

Enumerations
enum	spdk_bdev_nvme_multipath_policy { BDEV_NVME_MP_POLICY_ACTIVE_PASSIVE , BDEV_NVME_MP_POLICY_ACTIVE_ACTIVE }
enum	spdk_bdev_nvme_multipath_selector { BDEV_NVME_MP_SELECTOR_ROUND_ROBIN = 1 , BDEV_NVME_MP_SELECTOR_QUEUE_DEPTH }

Functions
int	spdk_bdev_nvme_create (struct spdk_nvme_transport_id *trid, const char *base_name, const char **names, uint32_t count, spdk_bdev_nvme_create_cb cb_fn, void *cb_ctx, struct spdk_nvme_ctrlr_opts *drv_opts, struct spdk_bdev_nvme_ctrlr_opts *bdev_opts, bool multipath)
	Connect to the NVMe controller and populate namespaces as bdevs.
void	spdk_bdev_nvme_set_multipath_policy (const char *name, enum spdk_bdev_nvme_multipath_policy policy, enum spdk_bdev_nvme_multipath_selector selector, uint32_t rr_min_io, spdk_bdev_nvme_set_multipath_policy_cb cb_fn, void *cb_arg)
	Set multipath policy of the NVMe bdev.
void	spdk_bdev_nvme_get_default_ctrlr_opts (struct spdk_bdev_nvme_ctrlr_opts *opts)

Detailed Description

Nvme block device abstraction layer.

Function Documentation

spdk_bdev_nvme_create()

int spdk_bdev_nvme_create	(	struct spdk_nvme_transport_id *	trid,
		const char *	base_name,
		const char **	names,
		uint32_t	count,
		spdk_bdev_nvme_create_cb	cb_fn,
		void *	cb_ctx,
		struct spdk_nvme_ctrlr_opts *	drv_opts,
		struct spdk_bdev_nvme_ctrlr_opts *	bdev_opts,
		bool	multipath )

Connect to the NVMe controller and populate namespaces as bdevs.

Parameters

trid	Transport ID for nvme controller.
base_name	Base name for the nvme subsystem.
names	Pointer to string array to get bdev names.
count	Maximum count of the string array 'names'. Restricts the length of 'names' array only, not the count of bdevs created.
cb_fn	Callback function to be called after all the bdevs are created or updated if already created.
cb_ctx	Context to pass to cb_fn.
drv_opts	NVMe driver options.
bdev_opts	NVMe bdev options.
multipath	Whether to enable multipathing (if true) else failover mode.

Returns

0 on success, negative errno on failure.

spdk_bdev_nvme_set_multipath_policy()

void spdk_bdev_nvme_set_multipath_policy	(	const char *	name,
		enum spdk_bdev_nvme_multipath_policy	policy,
		enum spdk_bdev_nvme_multipath_selector	selector,
		uint32_t	rr_min_io,
		spdk_bdev_nvme_set_multipath_policy_cb	cb_fn,
		void *	cb_arg )

Set multipath policy of the NVMe bdev.

Parameters

name	NVMe bdev name.
policy	Multipath policy (active-passive or active-active).
selector	Multipath selector (round_robin, queue_depth).
rr_min_io	Number of IO to route to a path before switching to another for round-robin.
cb_fn	Function to be called back after completion.
cb_arg	Argument passed to the callback function.