summaryrefslogtreecommitdiffstats
path: root/sys-utils/fallocate.1
diff options
context:
space:
mode:
authorKarel Zak2014-06-26 12:38:04 +0200
committerKarel Zak2014-06-26 12:38:04 +0200
commitb7f3f147f24f377c63c80f3aca38e2881774fa08 (patch)
tree20b039ec0c9d2109d0585c0fa1c7e6d1acecef34 /sys-utils/fallocate.1
parentfallocate: make man page readable for humans (diff)
downloadkernel-qcow2-util-linux-b7f3f147f24f377c63c80f3aca38e2881774fa08.tar.gz
kernel-qcow2-util-linux-b7f3f147f24f377c63c80f3aca38e2881774fa08.tar.xz
kernel-qcow2-util-linux-b7f3f147f24f377c63c80f3aca38e2881774fa08.zip
fallocate: use err_exclusive_options(), cleanup getopt_long() stuff
Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/fallocate.1')
-rw-r--r--sys-utils/fallocate.110
1 files changed, 7 insertions, 3 deletions
diff --git a/sys-utils/fallocate.1 b/sys-utils/fallocate.1
index 0496d4a48..b03f19b59 100644
--- a/sys-utils/fallocate.1
+++ b/sys-utils/fallocate.1
@@ -38,6 +38,10 @@ The \fIlength\fR and \fIoffset\fR arguments may be followed by the multiplicativ
suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
(the "iB" is optional, e.g. "K" has the same meaning as "KiB") or the suffixes
KB=1000, MB=1000*1000, and so on for GB, TB, PB, EB, ZB and YB.
+
+The options \fB\-\-collapse-range\fP, \fB\-\-dig-holes\fP, \fB\-\-punch-hole\fP and
+\fB\-\-zero-range\fP are mutually exclusive.
+
.IP "\fB\-n, \-\-keep-size\fP"
Do not modify the apparent length of the file. This may effectively allocate
blocks past EOF, which can be removed with a truncate.
@@ -68,7 +72,8 @@ Removes a byte range from a file, without leaving a hole. The byte range
to be collapsed starts at \fIoffset\fP and continues
for \fIlength\fR bytes. At the completion of the operation, the contents of
the file starting at the location offset+length will be appended at the
-location offset, and the file will be \fIlength\fR bytes smaller.
+location offset, and the file will be \fIlength\fR bytes smaller. The option
+\fB\-\-keep\-size\fR may not be specified for colapse range operation.
Available since Linux 3.15 for ext4 (only for extent-based files) and XFS.
.IP "\fB\-z, \-\-zero-range\fP"
@@ -84,8 +89,7 @@ partial blocks at the either end of the range), and I/O is
(otherwise) required only to update metadata.
Option \fB\-\-keep\-size\fP can be specified to prevent file length
-modification. This option may not be specified at the same time as the
-\fB\-\-punch-hole\fP or \fB\-\-collapse-range\fP option.
+modification.
Available since Linux 3.14 for ext4 (only for extent-based files) and XFS.
.IP "\fB\-o, \-\-offset\fP \fIoffset\fP