docs: clarify KiB vs. KB in man pages
Update the man pages of blkid, wipefs, fallocate, fstrim, losetup and hexdump to clarify the suffixes for the numerical values of the offset and size/length arguments regarding KiB=1024 vs KB=1000. Also mention the ZiB/YiB and ZB/YB suffixes supported by strtosize(). Signed-off-by: Bernhard Voelker <mail@bernhard-voelker.de>
This commit is contained in:
parent
916a743891
commit
d636d6d82a
|
@ -69,9 +69,10 @@ has two main forms of operation: either searching for a device with a
|
||||||
specific NAME=value pair, or displaying NAME=value pairs for one or
|
specific NAME=value pair, or displaying NAME=value pairs for one or
|
||||||
more specified devices.
|
more specified devices.
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
The \fIsize\fR and \fIoffset\fR arguments may be followed by binary (2^N)
|
The \fIsize\fR and \fIoffset\fR arguments may be followed by the multiplicative
|
||||||
suffixes KiB, MiB, GiB, TiB, PiB and EiB (the "iB" is optional, e.g. "K" has the
|
suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
|
||||||
same meaning as "KiB") or decimal (10^N) suffixes KB, MB, GB, PB and EB.
|
(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, PB, EB, ZB and YB.
|
||||||
.TP
|
.TP
|
||||||
.BI \-c " cachefile"
|
.BI \-c " cachefile"
|
||||||
Read from
|
Read from
|
||||||
|
|
|
@ -47,9 +47,10 @@ Specify the location (in bytes) of the signature which should be erased from the
|
||||||
device. The \fIoffset\fR number may include a "0x" prefix; then the number will be
|
device. The \fIoffset\fR number may include a "0x" prefix; then the number will be
|
||||||
interpreted as a hex value. It is possible to specify multiple \fB-o\fR options.
|
interpreted as a hex value. It is possible to specify multiple \fB-o\fR options.
|
||||||
|
|
||||||
The \fIoffset\fR argument may be followed by binary (2^N) suffixes KiB, MiB,
|
The \fIoffset\fR argument may be followed by the multiplicative
|
||||||
GiB, TiB, PiB and EiB (the "iB" is optional, e.g. "K" has the same meaning as
|
suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
|
||||||
"KiB") or decimal (10^N) suffixes KB, MB, GB, PB and EB.
|
(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, PB, EB, ZB and YB.
|
||||||
.IP "\fB\-p, \-\-parsable\fP"
|
.IP "\fB\-p, \-\-parsable\fP"
|
||||||
Print out in parsable instead of printable format. Encode all potentially unsafe
|
Print out in parsable instead of printable format. Encode all potentially unsafe
|
||||||
characters of a string to the corresponding hex value prefixed by '\\x'.
|
characters of a string to the corresponding hex value prefixed by '\\x'.
|
||||||
|
|
|
@ -26,9 +26,10 @@ The exit code returned by
|
||||||
is 0 on success and 1 on failure.
|
is 0 on success and 1 on failure.
|
||||||
.PP
|
.PP
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
The \fIlength\fR and \fIoffset\fR arguments may be followed by binary (2^N)
|
The \fIlength\fR and \fIoffset\fR arguments may be followed by the multiplicative
|
||||||
suffixes KiB, MiB, GiB, TiB, PiB and EiB (the "iB" is optional, e.g. "K" has the
|
suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
|
||||||
same meaning as "KiB") or decimal (10^N) suffixes KB, MB, GB, PB and EB.
|
(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, PB, EB, ZB and YB.
|
||||||
.IP "\fB\-n, \-\-keep-size\fP"
|
.IP "\fB\-n, \-\-keep-size\fP"
|
||||||
Do not modify the apparent length of the file. This may effectively allocate
|
Do not modify the apparent length of the file. This may effectively allocate
|
||||||
blocks past EOF, which can be removed with a truncate.
|
blocks past EOF, which can be removed with a truncate.
|
||||||
|
|
|
@ -31,9 +31,10 @@ is mounted.
|
||||||
|
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
The \fIoffset\fR, \fIlength\fR, and \fIminimum-free-extent\fR arguments may be
|
The \fIoffset\fR, \fIlength\fR, and \fIminimum-free-extent\fR arguments may be
|
||||||
followed by binary (2^N) suffixes KiB, MiB, GiB, TiB, PiB and EiB (the "iB" is
|
followed by the multiplicative suffixes KiB=1024, MiB=1024*1024, and so on for
|
||||||
optional, e.g. "K" has the same meaning as "KiB") or decimal (10^N) suffixes
|
GiB, TiB, PiB, EiB, ZiB and YiB (the "iB" is optional, e.g. "K" has the same
|
||||||
KB, MB, GB, PB and EB.
|
meaning as "KiB") or the suffixes KB=1000, MB=1000*1000, and so on for GB, PB,
|
||||||
|
EB, ZB and YB.
|
||||||
.IP "\fB\-h, \-\-help\fP"
|
.IP "\fB\-h, \-\-help\fP"
|
||||||
Print help and exit.
|
Print help and exit.
|
||||||
.IP "\fB\-o, \-\-offset\fP \fIoffset\fP"
|
.IP "\fB\-o, \-\-offset\fP \fIoffset\fP"
|
||||||
|
|
|
@ -69,9 +69,10 @@ to detach loop devices and to query the status of a loop device. If only the
|
||||||
device is shown.
|
device is shown.
|
||||||
|
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
The \fIsize\fR and \fIoffset\fR arguments may be followed by binary (2^N)
|
+The \fIsize\fR and \fIoffset\fR arguments may be followed by the multiplicative
|
||||||
suffixes KiB, MiB, GiB, TiB, PiB and EiB (the "iB" is optional, e.g. "K" has the
|
+suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
|
||||||
same meaning as "KiB") or decimal (10^N) suffixes KB, MB, GB, PB and EB.
|
+(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, PB, EB, ZB and YB.
|
||||||
|
|
||||||
.IP "\fB\-a, \-\-all\fP"
|
.IP "\fB\-a, \-\-all\fP"
|
||||||
show status of all loop devices. Note that not all information are accessible
|
show status of all loop devices. Note that not all information are accessible
|
||||||
|
|
|
@ -44,9 +44,10 @@ utility is a filter which displays the specified files, or
|
||||||
standard input if no files are specified, in a user-specified
|
standard input if no files are specified, in a user-specified
|
||||||
format.
|
format.
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
The \fIlength\fR and \fIoffset\fR arguments may be followed by binary (2^N)
|
The \fIlength\fR and \fIoffset\fR arguments may be followed by the multiplicative
|
||||||
suffixes KiB, MiB, GiB, TiB, PiB and EiB (the "iB" is optional, e.g. "K" has the
|
suffixes KiB=1024, MiB=1024*1024, and so on for GiB, TiB, PiB, EiB, ZiB and YiB
|
||||||
same meaning as "KiB") or decimal (10^N) suffixes KB, MB, GB, PB and EB.
|
(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, PB, EB, ZB and YB.
|
||||||
.TP
|
.TP
|
||||||
.B \-b
|
.B \-b
|
||||||
\fIOne-byte octal display\fR. Display the input offset in hexadecimal,
|
\fIOne-byte octal display\fR. Display the input offset in hexadecimal,
|
||||||
|
|
Loading…
Reference in New Issue