]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
fallocate: (man,usage) correct the alphabetical sorting of the options
authorBenno Schulenberg <bensberg@telfort.nl>
Thu, 18 Sep 2025 08:57:07 +0000 (10:57 +0200)
committerKarel Zak <kzak@redhat.com>
Tue, 23 Sep 2025 12:07:09 +0000 (14:07 +0200)
Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>
sys-utils/fallocate.1.adoc
sys-utils/fallocate.c

index 0b7ea39dbbd87d0c2a62b3517df00fbbea266919..4a96d009d2b48859db7a0cea574a7b5ed28aa2d3 100644 (file)
@@ -64,6 +64,13 @@ Supported for XFS (since Linux 2.6.38), ext4 (since Linux 3.0), Btrfs (since Lin
 *-v*, *--verbose*::
 Enable verbose mode.
 
+*-w*, *--write-zeroes*::
+Zeroes space in the byte range starting at _offset_ and continuing for _length_ bytes. Within the specified range, written blocks are preallocated for the regions that span the holes in the file. After a successful call, subsequent reads from this range will return zeroes and subsequent writes to that range do not require further changes to the file mapping metadata.
++
+Zeroing is done within the filesystem. The filesystem may use a hardware-accelerated zeroing command or may submit regular writes. The behavior depends on the filesystem design and the available hardware.
++
+Option *--keep-size* cannot be specified for the write-zeroes operation because allocating written blocks beyond the inode size is not permitted.
+
 *-x*, *--posix*::
 Enable POSIX operation mode. In that mode allocation operation always completes, but it may take longer time when fast allocation is not supported by the underlying filesystem.
 
@@ -76,13 +83,6 @@ Option *--keep-size* can be specified to prevent file length modification.
 +
 Available since Linux 3.14 for ext4 (only for extent-based files) and XFS.
 
-*-w*, *--write-zeroes*::
-Zeroes space in the byte range starting at _offset_ and continuing for _length_ bytes. Within the specified range, written blocks are preallocated for the regions that span the holes in the file. After a successful call, subsequent reads from this range will return zeroes and subsequent writes to that range do not require further changes to the file mapping metadata.
-+
-Zeroing is done within the filesystem. The filesystem may use a hardware-accelerated zeroing command or may submit regular writes. The behavior depends on the filesystem design and the available hardware.
-+
-Option *--keep-size* cannot be specified for the write-zeroes operation because allocating written blocks beyond the inode size is not permitted.
-
 include::man-common/help-version.adoc[]
 
 == AUTHORS
index afd615537cecace7faad298397bc136c545b7ae2..f06009483a4cebb1750702a8429a8047476a5eae 100644 (file)
@@ -97,12 +97,12 @@ static void __attribute__((__noreturn__)) usage(void)
        fputs(_(" -n, --keep-size      maintain the apparent size of the file\n"), out);
        fputs(_(" -o, --offset <num>   offset for range operations, in bytes\n"), out);
        fputs(_(" -p, --punch-hole     replace a range with a hole (implies -n)\n"), out);
-       fputs(_(" -z, --zero-range     zero and ensure allocation of a range\n"), out);
+       fputs(_(" -v, --verbose        verbose mode\n"), out);
        fputs(_(" -w, --write-zeroes   write zeroes and ensure allocation of a range\n"), out);
 #ifdef HAVE_POSIX_FALLOCATE
        fputs(_(" -x, --posix          use posix_fallocate(3) instead of fallocate(2)\n"), out);
 #endif
-       fputs(_(" -v, --verbose        verbose mode\n"), out);
+       fputs(_(" -z, --zero-range     zero and ensure allocation of a range\n"), out);
 
        fputs(USAGE_SEPARATOR, out);
        fprintf(out, USAGE_HELP_OPTIONS(22));