From: Anna Schumaker <Anna.Schumaker@netapp.com>
Date: Thu, 4 Aug 2016 01:29:49 +0000 (+1000)
Subject: xfs_io: Update man page for copy_range command
X-Git-Tag: v4.7.0~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8f0529438eb09bab1dbd1072e61a973c6e1c1cfb;p=thirdparty%2Fxfsprogs-dev.git

xfs_io: Update man page for copy_range command

Signed-off-by: Anna Schumaker <Anna.Schumaker@Netapp.com>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Signed-off-by: Dave Chinner <david@fromorbit.com>
---

diff --git a/man/man8/xfs_io.8 b/man/man8/xfs_io.8
index b0300bb5c..2c56f0928 100644
--- a/man/man8/xfs_io.8
+++ b/man/man8/xfs_io.8
@@ -556,6 +556,39 @@ Print timing statistics in a condensed format.
 .TP
 .B \-q
 Do not print timing statistics at all.
+.RE
+.PD
+.TP
+.TP
+.BI "copy_range [ -s " src_offset " ] [ -d " dst_offset " ] [ -l " length " ] src_file"
+On filesystems that support the
+.BR copy_file_range (2)
+system call, copies data from the
+.I src_file
+into the open file.  If
+.IR src_offset ,
+.IR dst_offset ,
+and
+.I length
+are omitted the contents of src_file will be copied to the beginning of the
+open file, overwriting any data already there.
+.RS 1.0i
+.PD 0
+.TP 0.4i
+.B \-s
+Copy data from
+.I src_file
+beginning from
+.IR src_offset .
+.TP
+.B \-d
+Copy data into the open file beginning at
+.IR dst_offset .
+.TP
+.B \-l
+Copy up to
+.I length
+bytes of data.
 
 .SH MEMORY MAPPED I/O COMMANDS
 .TP