summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHumble Chirammal <hchiramm@redhat.com>2014-05-19 17:11:47 +0530
committerAnand Avati <avati@redhat.com>2014-05-19 21:03:01 -0700
commit5e2e97300d6e5248bb1c58825e5fe586e93c7cf4 (patch)
treef5393a459f5564055dec24d593ef5fb944428bc2
parent0b4fc6c8bfed9ccc87d97056399a848c8990e500 (diff)
doc: zerofill api documentation
Change-Id: I437735d68fdcc4a55f12fd51b1d40cd7a32ad783 BUG: 1086756 Signed-off-by: Humble Chirammal <hchiramm@redhat.com> Reviewed-on: http://review.gluster.org/7800 Reviewed-by: Niels de Vos <ndevos@redhat.com> Reviewed-by: Anand Avati <avati@redhat.com> Tested-by: Anand Avati <avati@redhat.com>
-rw-r--r--doc/features/zerofill.md26
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/features/zerofill.md b/doc/features/zerofill.md
new file mode 100644
index 00000000000..c0f1fc5014c
--- /dev/null
+++ b/doc/features/zerofill.md
@@ -0,0 +1,26 @@
+#zerofill API for GlusterFS
+zerofill() API would allow creation of pre-allocated and zeroed-out files on GlusterFS volumes by offloading the zeroing part to server and/or storage (storage offloads use SCSI WRITESAME).
+## Description
+
+Zerofill writes zeroes to a file in the specified range. This fop will be useful when a whole file needs to be initialized with zero (could be useful for zero filled VM disk image provisioning or during scrubbing of VM disk images).
+
+Client/application can issue this FOP for zeroing out. Gluster server will zero out required range of bytes ie server offloaded zeroing. In the absence of this fop, client/application has to repetitively issue write (zero) fop to the server, which is very inefficient method because of the overheads involved in RPC calls and acknowledgements.
+
+WRITESAME is a SCSI T10 command that takes a block of data as input and writes the same data to other blocks and this write is handled completely within the storage and hence is known as offload . Linux ,now has support for SCSI WRITESAME command which is exposed to the user in the form of BLKZEROOUT ioctl. BD Xlator can exploit BLKZEROOUT ioctl to implement this fop. Thus zeroing out operations can be completely offloaded to the storage device,
+making it highly efficient.
+
+The fop takes two arguments offset and size. It zeroes out 'size' number of bytes in an opened file starting from 'offset' position.
+This feature adds zerofill support to the following areas:
+> - libglusterfs
+- io-stats
+- performance/md-cache,open-behind
+- quota
+- cluster/afr,dht,stripe
+- rpc/xdr
+- protocol/client,server
+- io-threads
+- marker
+- storage/posix
+- libgfapi
+
+Client applications can exploit this fop by using glfs_zerofill introduced in libgfapi.FUSE support to this fop has not been added as there is no system call for this fop.