numam-spdk/doc/lvol.md
Piotr Pelplinski 5226e9082d lvol: Documentation
Signed-off-by: Piotr Pelplinski <piotr.pelplinski@intel.com>
Change-Id: I23e14bd1568dade96e5503598a3e360c951d6d78
Reviewed-on: https://review.gerrithub.io/369250
Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
Reviewed-by: Jim Harris <james.r.harris@intel.com>
Tested-by: SPDK Automated Test System <sys_sgsw@intel.com>
2017-09-14 19:31:02 -04:00

1.1 KiB

Logical volume store

A logical volume store is an SPDK blobstore with a special super blob denoting the blobstore. This super blob is to different from SPDK blobstores used for BlobFS.

Logical volume

A logical volume is an SPDK blob created from an lvolstore.

An lvol is uniquely identified by its blob ID and the UUID of the lvolstore from which it was created.

Logical volume block device

Representation of an SPDK block device (spdk_bdev) with an lvol implementation. A logical volume block device translates generic SPDK block device I/O (spdk_bdev_io) operations into the equivalent SPDK blob operations.

RPC overview

There are few logical volumes specific calls.

  • construct_lvol_store bdev_name Constructs lvolstore on specified bdev
  • destroy_lvol_store bdev_name Destroy lvolstore on specified bdev
  • construct_lvol_bdev uuid size Constructs lvol bdev on lvolstore specified by uuid with specified size
  • resize_lvol_bdev bdev_name size Resizes specified lvol bdev

Note that destroying lvol store requires using call destroy_lvol_store, while deleting single lvol requires using delete_bdev rpc call.