From 94c79620db4451bf804d6ab631c9ca59759dbc21 Mon Sep 17 00:00:00 2001
From: Prasanna Kumar Kalever <prasanna.kalever@redhat.com>
Date: Mon, 12 Jun 2017 11:59:13 +0530
Subject: 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>
---
 docs/gluster-block.8 | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

(limited to 'docs')

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
 
-- 
cgit