doc: split bdev userguide update

Signed-off-by: Monica Kenguva <monica.kenguva@intel.com>
Change-Id: Ibbeefa306fcbac6e942a016bf918f1465c68fa24
Reviewed-on: https://review.spdk.io/gerrit/c/spdk/spdk/+/3684
Community-CI: Mellanox Build Bot
Community-CI: Broadcom CI
Tested-by: SPDK CI Jenkins <sys_sgci@intel.com>
Reviewed-by: Shuhei Matsumoto <shuhei.matsumoto.xt@hitachi.com>
Reviewed-by: Ben Walker <benjamin.walker@intel.com>
This commit is contained in:
Monica Kenguva 2020-08-06 22:38:56 +00:00 committed by Tomasz Zawadzki
parent d1b0a447f3
commit e25747e547

View File

@ -512,6 +512,28 @@ Example commands
`rpc.py bdev_raid_delete Raid0`
# Split {#bdev_ug_split}
The split block device module takes an underlying block device and splits it into
several smaller equal-sized virtual block devices. This serves as an example to create
more vbdevs on a given base bdev for user testing.
Example commands
To create four split bdevs with base bdev_b0 use the `bdev_split_create` command.
Each split bdev will be one fourth the size of the base bdev.
`rpc.py bdev_split_create bdev_b0 4`
The `split_size_mb`(-s) parameter restricts the size of each split bdev.
The total size of all split bdevs must not exceed the base bdev size.
`rpc.py bdev_split_create bdev_b0 4 -s 128`
To remove the split bdevs, use the `bdev_split_delete` command with the base bdev name.
`rpc.py bdev_split_delete bdev_b0`
# Uring {#bdev_ug_uring}
The uring bdev module issues I/O to kernel block devices using the io_uring Linux kernel API. This module requires liburing.