lvol: Logical volume implementation (27f44662) · Commits · Public Repositories / spdk

CHANGELOG.md

+11 −0

Original line number	Diff line number	Diff line
		@@ -2,6 +2,10 @@

		## v17.10: (Upcoming Release)

		### New dependency

		libuuid added as new depenency for logical volumes.

		### Block Device Abstraction Layer (bdev)

		An [fio](http://github.com/axboe/fio) plugin was added that can route
		@@ -80,6 +84,13 @@ which will show up in tools like `gdb`.
		The API spdk_trace_dump() now takes a new parameter to allow the caller to
		specify stdout or stderr for example.

		### Logical Volumes

		Logical volumes library built on top of SPDK blobstore has been added.
		It is possible create logical volumes on top of other devices using RPC.

		See [logical volumes](http://www.spdk.io/doc/lvol.html) documentation for more information.

		## v17.07: Build system improvements, userspace vhost-blk target, and GPT bdev

		### Build System

include/spdk/lvol.h

0 → 100644

+68 −0

Original line number	Diff line number	Diff line
		/*-
		* 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.
		*/

		/** \file
		* Logical Volume Interface
		*/

		#ifndef SPDK_LVOL_H
		#define SPDK_LVOL_H

		#include "spdk/queue.h"
		#include "spdk/blob.h"
		#include <uuid/uuid.h>

		struct spdk_lvol_store;
		struct spdk_lvol;

		typedef void (spdk_lvs_op_with_handle_complete)(void cb_arg, struct spdk_lvol_store *lvol_store,
		int lvserrno);
		typedef void (spdk_lvs_op_complete)(void cb_arg, int lvserrno);
		typedef void (spdk_lvol_op_complete)(void cb_arg, int lvolerrno);
		typedef void (spdk_lvol_op_with_handle_complete)(void cb_arg, struct spdk_lvol *lvol,
		int lvolerrno);

		int spdk_lvs_init(struct spdk_bs_dev bs_dev, spdk_lvs_op_with_handle_complete cb_fn, void cb_arg);
		int spdk_lvs_unload(struct spdk_lvol_store lvol_store, spdk_lvs_op_complete cb_fn, void cb_arg);
		int spdk_lvol_create(struct spdk_lvol_store *lvs, uint64_t sz,
		spdk_lvol_op_with_handle_complete cb_fn, void *cb_arg);
		int spdk_lvol_resize(struct spdk_lvol *lvol, uint64_t sz,
		spdk_lvol_op_complete cb_fn, void *cb_arg);
		void spdk_lvol_destroy(struct spdk_lvol *lvol);
		void spdk_lvol_close(struct spdk_lvol *lvol);
		struct spdk_io_channel spdk_lvol_get_io_channel(struct spdk_lvol lvol);
		struct lvol_store_bdev vbdev_get_lvs_bdev_by_lvs(struct spdk_lvol_store lvs_orig);
		struct spdk_lvol vbdev_get_lvol_by_name(const char name);
		struct spdk_lvol_store *vbdev_get_lvol_store_by_uuid(uuid_t uuid);

		#endif /* SPDK_LVOL_H */

include/spdk_internal/bdev.h

+4 −0

Original line number	Diff line number	Diff line
		@@ -222,6 +222,8 @@ struct spdk_bdev {

		TAILQ_ENTRY(spdk_bdev) vbdev_link;

		bool bdev_opened;

		bool bdev_opened_for_write;

		/**
		@@ -425,6 +427,8 @@ void spdk_scsi_nvme_translate(const struct spdk_bdev_io *bdev_io,

		void spdk_bdev_module_list_add(struct spdk_bdev_module_if *bdev_module);

		bool spdk_is_bdev_opened(struct spdk_bdev *bdev);

		static inline struct spdk_bdev_io *
		spdk_bdev_io_from_ctx(void *ctx)
		{

include/spdk_internal/lvolstore.h

0 → 100644

+93 −0

Original line number	Diff line number	Diff line
		/*-
		* 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.
		*/

		#ifndef SPDK_INTERNAL_LVOLSTORE_H
		#define SPDK_INTERNAL_LVOLSTORE_H

		#include "spdk/lvol.h"
		#include "spdk_internal/bdev.h"

		struct spdk_lvol_store_req {
		union {
		struct {
		spdk_lvs_op_complete cb_fn;
		void *cb_arg;
		struct spdk_bdev *base_bdev;
		} lvs_basic;

		struct {
		spdk_lvs_op_with_handle_complete cb_fn;
		void *cb_arg;
		struct spdk_lvol_store *lvol_store;
		struct spdk_bs_dev *bs_dev;
		struct spdk_bdev *base_bdev;
		} lvs_handle;

		struct {
		spdk_lvol_op_complete cb_fn;
		void *cb_arg;
		} lvol_basic;

		struct {
		spdk_lvol_op_with_handle_complete cb_fn;
		void *cb_arg;
		struct spdk_lvol *lvol;
		} lvol_handle;
		} u;
		};

		struct spdk_lvol_store {
		struct spdk_bs_dev *bs_dev;
		struct spdk_blob_store *blobstore;
		uuid_t uuid;
		uint64_t page_size;
		struct spdk_lvol_store_req *destruct_req;
		TAILQ_HEAD(, spdk_lvol) lvols;
		};

		struct spdk_lvol {
		struct spdk_lvol_store *lvol_store;
		struct spdk_blob *blob;
		uint64_t sz;
		spdk_blob_id blob_id;
		char *name;
		bool close_only;
		struct spdk_bdev *bdev;
		TAILQ_ENTRY(spdk_lvol) link;
		};

		struct lvol_task {
		enum spdk_bdev_io_status status;
		};

		#endif /* SPDK_INTERNAL_LVOLSTORE_H */

lib/Makefile

+1 −1

Original line number	Diff line number	Diff line
		@@ -35,7 +35,7 @@ SPDK_ROOT_DIR := $(abspath $(CURDIR)/..)
		include $(SPDK_ROOT_DIR)/mk/spdk.common.mk

		DIRS-y += bdev blob blobfs conf copy cunit event json jsonrpc \
		log env_dpdk net rpc trace util nvme nvmf scsi ioat \
		log lvol env_dpdk net rpc trace util nvme nvmf scsi ioat \
		ut_mock iscsi
		ifeq ($(OS),Linux)
		DIRS-y += nbd