summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorPrasanna Kumar Kalever <prasanna.kalever@redhat.com>2017-06-12 11:59:13 +0530
committerPrasanna Kumar Kalever <prasanna.kalever@redhat.com>2017-06-22 16:30:46 +0530
commit94c79620db4451bf804d6ab631c9ca59759dbc21 (patch)
treeee5c0e9430fb30812753ac1911bd8b5c163cb5fd /docs
parent8bb5dd787e84f719940230adb24642653fcaec77 (diff)
block: add support to prealloc = full | no option
currently we allocate sparse files for block backends in the gluster volume, with 'prealloc = full' option introduced by this patch we should be able to fully preallocate the backend block file. Change-Id: Ibf32df5f978f732a3fd248693170463da6d08268 Signed-off-by: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/gluster-block.810
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/gluster-block.8 b/docs/gluster-block.8
index 83cfdf3..05f86c9 100644
--- a/docs/gluster-block.8
+++ b/docs/gluster-block.8
@@ -25,15 +25,18 @@ Note that the gluster-blockd daemon is responsible for block management, hence t
.SH COMMANDS
.SS
-\fBcreate\fR <VOLNAME/NEW-BLOCKNAME> [ha <COUNT>] [auth enable|disable] <HOST1[,HOST2,..]> <BYTES>
+\fBcreate\fR <VOLNAME/NEW-BLOCKNAME> [ha <COUNT>] [auth <enable|disable>] [prealloc <full|no>] <HOST1[,HOST2,..]> <BYTES>
create block device.
.TP
[ha <COUNT>]
multipath requirement for high availability (default: 1)
.TP
-[auth enable|disable]
+[auth <enable|disable>]
authentication setting (default: disable)
.TP
+[prealloc <full|no>]
+"full" mode preallocates space by writing zeros to storage. (default: no)
+.TP
<HOST1,[HOST2....]>
servers in the pool where targets will be exported.
.TP
@@ -82,6 +85,9 @@ To create a block device of size 1GiB
To create a block device of size 1GiB with auth enable
.B # gluster-block create blockVol/sampleBlock auth enable ${HOST} 1GiB
+To create a block device of size 1GiB, by preallocating storage with zero fill
+.B # gluster-block create blockVol/sampleBlock prealloc full ${HOST} 1GiB
+
To create a block device of size 1GiB with multi-path(replica) 3
.B # gluster-block create blockVol/sampleBlock ha 3 ${HOST1},${HOST2},${HOST3} 1GiB