d/numam-spdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: update lvol bdev documentation with changes for 18.01

Browse Source 
Thin provisioning for lvol bdevs enabled starting with 4132ac5.
Unmap is now supported on lvol starting with patch cf6fe9b.

Change-Id: I10c47f9e1af31785caf27fd73750461c9cde57c4
Signed-off-by: Tomasz Zawadzki <tomasz.zawadzki@intel.com>
Reviewed-on: https://review.gerrithub.io/397573
Reviewed-by: Daniel Verkamp <daniel.verkamp@intel.com>
Tested-by: SPDK Automated Test System <sys_sgsw@intel.com>
Reviewed-by: Jim Harris <james.r.harris@intel.com>
This commit is contained in:
Tomasz Zawadzki 2018-01-31 09:55:43 -05:00 committed by Jim Harris
parent 9856fe06e5
commit 2b574ec2f6
1 changed files with 4 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/lvol.md
View File

@ -26,6 +26,7 @@ A logical volume is implemented as an SPDK blob created from an lvolstore. An lv
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. Combination of lvol ID and lvolstore UUID gives lvol_bdev name in a form "uuid/lvolid". block_size of the created bdev is always 4096, due to blobstore page size. Cluster_size is configurable by parameter. By default it is 1GiB.
Size of the new bdev will be rounded up to nearest multiple of cluster_size.
By default lvol bdevs claim part of lvol store equal to their set size. When thin provision option is enabled, no space is taken from lvol store until data is written to lvol bdev.
# Configuring Logical Volumes
@ -50,16 +51,17 @@ destroy_lvol_store [-h] uuid
single lvol requires using delete_bdev rpc call.
optional arguments:
-h, --help show help
get_lvol_stores [-h]
get_lvol_stores [-h] [NAME]
Display current logical volume store list
optional arguments:
-h, --help show help
NAME, show details of specified lvol store
```
RPC regarding lvol and spdk bdev:
```
construct_lvol_bdev [-h] uuid size
construct_lvol_bdev [-h] [-t] uuid size
Creates lvol with specified size on lvolstore specified by its uuid.
Then constructs spdk bdev on top of that lvol and presents it as spdk bdev.
Returns the name of new spdk bdev
@ -76,6 +78,5 @@ delete_bdev [-h] bdev_name
# Restrictions
- Unmap is not supported.
- Nesting logical volumes on each other is not supported.
- Resizing lvol bdev is experimental. Code is present but not used.