findmnt: improve formatting and wording of the man page
Signed-off-by: Benno Schulenberg <bensberg@justemail.net>
This commit is contained in:
parent
8f6a58efde
commit
c00043e542
|
@ -1,4 +1,4 @@
|
||||||
.TH FINDMNT 8 "June 2014" "util-linux" "System Administration"
|
.TH FINDMNT 8 "June 2015" "util-linux" "System Administration"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
findmnt \- find a filesystem
|
findmnt \- find a filesystem
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
|
@ -18,7 +18,7 @@ findmnt \- find a filesystem
|
||||||
.SH DESCRIPTION
|
.SH DESCRIPTION
|
||||||
.B findmnt
|
.B findmnt
|
||||||
will list all mounted filesytems or search for a filesystem. The
|
will list all mounted filesytems or search for a filesystem. The
|
||||||
.B findmnt
|
.B \%findmnt
|
||||||
command is able to search in
|
command is able to search in
|
||||||
.IR /etc/fstab ,
|
.IR /etc/fstab ,
|
||||||
.IR /etc/mtab
|
.IR /etc/mtab
|
||||||
|
@ -30,14 +30,14 @@ or
|
||||||
.IR mountpoint
|
.IR mountpoint
|
||||||
is not given, all filesystems are shown.
|
is not given, all filesystems are shown.
|
||||||
.PP
|
.PP
|
||||||
The device may be specified by device name, maj:min, filesystem LABEL or UUID,
|
The device may be specified by device name, major:minor numbers,
|
||||||
or partition PARTUUID or PARTLABEL. Note that
|
filesystem label or UUID, or partition label or UUID. Note that
|
||||||
.B findmnt
|
.B \%findmnt
|
||||||
follows
|
follows
|
||||||
.BR mount (8)
|
.BR mount (8)
|
||||||
behavior where a device name may be interpreted
|
behavior where a device name may be interpreted
|
||||||
as a mountpoint (and vice versa) if the \fB--target\fR, \fB--mountpoint\fR or
|
as a mountpoint (and vice versa) if the \fB\-\-target\fR, \fB\-\-mountpoint\fR or
|
||||||
\fB--source\fR options are not specified.
|
\fB\-\-source\fR options are not specified.
|
||||||
.PP
|
.PP
|
||||||
The command prints all mounted filesystems in the tree-like format by default.
|
The command prints all mounted filesystems in the tree-like format by default.
|
||||||
.SH OPTIONS
|
.SH OPTIONS
|
||||||
|
@ -49,7 +49,7 @@ Disable all built-in filters and print all filesystems.
|
||||||
Use ascii characters for tree formatting.
|
Use ascii characters for tree formatting.
|
||||||
.TP
|
.TP
|
||||||
.BR \-b , " \-\-bytes"
|
.BR \-b , " \-\-bytes"
|
||||||
Print the SIZE, USED and AVAIL column in bytes rather than in a human-readable format.
|
Print the SIZE, USED and AVAIL columns in bytes rather than in a human-readable format.
|
||||||
.TP
|
.TP
|
||||||
.BR \-C , " \-\-nocanonicalize"
|
.BR \-C , " \-\-nocanonicalize"
|
||||||
Do not canonicalize paths at all. This option affects the comparing of paths
|
Do not canonicalize paths at all. This option affects the comparing of paths
|
||||||
|
@ -62,7 +62,7 @@ Canonicalize all printed paths.
|
||||||
Imitate the output of
|
Imitate the output of
|
||||||
.BR df (1).
|
.BR df (1).
|
||||||
This option is equivalent to
|
This option is equivalent to
|
||||||
.B -o SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET
|
.B \-o\ SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET
|
||||||
but excludes all pseudo filesystems.
|
but excludes all pseudo filesystems.
|
||||||
Use \fB\-\-all\fP to print all filesystems.
|
Use \fB\-\-all\fP to print all filesystems.
|
||||||
.TP
|
.TP
|
||||||
|
@ -73,7 +73,7 @@ or
|
||||||
.BR backward .
|
.BR backward .
|
||||||
.TP
|
.TP
|
||||||
.BR \-e , " \-\-evaluate"
|
.BR \-e , " \-\-evaluate"
|
||||||
Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) to the device names.
|
Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) to the corresponding device names.
|
||||||
.TP
|
.TP
|
||||||
.BR \-F , " \-\-tab\-file \fIpath\fP"
|
.BR \-F , " \-\-tab\-file \fIpath\fP"
|
||||||
Search in an alternative file. If used with \fB\-\-fstab\fP, \fB\-\-mtab\fP
|
Search in an alternative file. If used with \fB\-\-fstab\fP, \fB\-\-mtab\fP
|
||||||
|
@ -104,7 +104,7 @@ option and the option \fB\-\-submounts\fP is not used or if more that one
|
||||||
source file (the option \fB\-F\fP) is specified.
|
source file (the option \fB\-F\fP) is specified.
|
||||||
.TP
|
.TP
|
||||||
.BR \-M , " \-\-mountpoint \fIpath\fP"
|
.BR \-M , " \-\-mountpoint \fIpath\fP"
|
||||||
Explicitly define the mountpoint file or directory. See also \fB\-\-target\fP.
|
Explicitly define the mountpoint file or directory. See also \fB\-\-target\fP.
|
||||||
.TP
|
.TP
|
||||||
.BR \-m , " \-\-mtab"
|
.BR \-m , " \-\-mtab"
|
||||||
Search in
|
Search in
|
||||||
|
@ -146,7 +146,7 @@ or
|
||||||
options are not specified.
|
options are not specified.
|
||||||
|
|
||||||
The default list of columns may be extended if \fIlist\fP is
|
The default list of columns may be extended if \fIlist\fP is
|
||||||
specified in the format \fI+list\fP (e.g. \fBfindmnt -o +PROPAGATION\fP).
|
specified in the format \fI+list\fP (e.g. \fBfindmnt \-o +PROPAGATION\fP).
|
||||||
.TP
|
.TP
|
||||||
.BR \-P , " \-\-pairs"
|
.BR \-P , " \-\-pairs"
|
||||||
Use key="value" output format. All potentially unsafe characters are hex-escaped (\\x<code>).
|
Use key="value" output format. All potentially unsafe characters are hex-escaped (\\x<code>).
|
||||||
|
@ -156,7 +156,7 @@ Monitor changes in the /proc/self/mountinfo file. Supported actions are: mount,
|
||||||
umount, remount and move. More than one action may be specified in a
|
umount, remount and move. More than one action may be specified in a
|
||||||
comma-separated list. All actions are monitored by default.
|
comma-separated list. All actions are monitored by default.
|
||||||
|
|
||||||
The time for which \fB--poll\fR will block can be restricted with the \fB\-\-timeout\fP
|
The time for which \fB\-\-poll\fR will block can be restricted with the \fB\-\-timeout\fP
|
||||||
or \fB\-\-first\-only\fP options.
|
or \fB\-\-first\-only\fP options.
|
||||||
|
|
||||||
The standard columns always use the new version of the information from the
|
The standard columns always use the new version of the information from the
|
||||||
|
@ -179,7 +179,7 @@ available for umount and remount actions
|
||||||
.BR \-R , " \-\-submounts"
|
.BR \-R , " \-\-submounts"
|
||||||
Print recursively all submounts for the selected filesystems. The restrictions
|
Print recursively all submounts for the selected filesystems. The restrictions
|
||||||
defined by options \fB\-t\fP, \fB\-O\fP, \fB\-S\fP, \fB\-T\fP and
|
defined by options \fB\-t\fP, \fB\-O\fP, \fB\-S\fP, \fB\-T\fP and
|
||||||
\fB\--direction\fP are not applied to submounts. All submounts are always
|
\fB\%\-\-direction\fP are not applied to submounts. All submounts are always
|
||||||
printed in tree-like order. The option enables the tree-like output format by
|
printed in tree-like order. The option enables the tree-like output format by
|
||||||
default. This option has no effect for \fB\-\-mtab\fP or \fB\-\-fstab\fP.
|
default. This option has no effect for \fB\-\-mtab\fP or \fB\-\-fstab\fP.
|
||||||
.TP
|
.TP
|
||||||
|
@ -187,28 +187,29 @@ default. This option has no effect for \fB\-\-mtab\fP or \fB\-\-fstab\fP.
|
||||||
Use raw output format. All potentially unsafe characters are hex-escaped (\\x<code>).
|
Use raw output format. All potentially unsafe characters are hex-escaped (\\x<code>).
|
||||||
.TP
|
.TP
|
||||||
.BR \-S , " \-\-source \fIspec\fP"
|
.BR \-S , " \-\-source \fIspec\fP"
|
||||||
Explicitly define the mount source. Supported are \fIdevice\fR, \fImaj:min\fR,
|
Explicitly define the mount source. Supported specifications are \fIdevice\fR,
|
||||||
\fILABEL=\fR, \fIUUID=\fR, \fIPARTLABEL=\fR or \fIPARTUUID=\fR.
|
\fImaj\fB:\fImin\fR, \fBLABEL=\fIlabel\fR, \fBUUID=\fIuuid\fR,
|
||||||
|
\fBPARTLABEL=\fIlabel\fR and \fBPARTUUID=\fIuuid\fR.
|
||||||
.TP
|
.TP
|
||||||
.BR \-s , " \-\-fstab"
|
.BR \-s , " \-\-fstab"
|
||||||
Search in
|
Search in
|
||||||
.IR /etc/fstab .
|
.IR /etc/fstab .
|
||||||
The output is in the list format (see \fB--list\fR).
|
The output is in the list format (see \fB\-\-list\fR).
|
||||||
.TP
|
.TP
|
||||||
.BR \-T , " \-\-target \fIpath\fP"
|
.BR \-T , " \-\-target \fIpath\fP"
|
||||||
Define the mount target. If the \fIpath\fR
|
Define the mount target. If \fIpath\fR
|
||||||
is not a mountpoint file or directory, then
|
is not a mountpoint file or directory, then
|
||||||
.B findmnt
|
.B findmnt
|
||||||
checks \fIpath\fR elements in reverse order to get the mountpoint (this feature is
|
checks the \fIpath\fR elements in reverse order to get the mountpoint (this feature is
|
||||||
supported only if search in kernel files and unsupported for \fB\-\-fstab\fP). It's
|
supported only when searching in kernel files and unsupported for \fB\-\-fstab\fP). It's
|
||||||
recommended to use the option \fB--mountpoint\fR when checks of \fIpath\fR elements is
|
recommended to use the option \fB\-\-mountpoint\fR when checks of \fIpath\fR elements are
|
||||||
unwanted and \fIpath\fR is a strictly specified mountpoint.
|
unwanted and \fIpath\fR is a strictly specified mountpoint.
|
||||||
.TP
|
.TP
|
||||||
.BR \-t , " \-\-types \fIlist\fP"
|
.BR \-t , " \-\-types \fIlist\fP"
|
||||||
Limit the set of printed filesystems. More than one type may be
|
Limit the set of printed filesystems. More than one type may be
|
||||||
specified in a comma-separated list. The list of filesystem types can be
|
specified in a comma-separated list. The list of filesystem types can be
|
||||||
prefixed with
|
prefixed with
|
||||||
.I no
|
.B no
|
||||||
to specify the filesystem types on which no action should be taken. For
|
to specify the filesystem types on which no action should be taken. For
|
||||||
more details see
|
more details see
|
||||||
.BR mount (8).
|
.BR mount (8).
|
||||||
|
@ -228,10 +229,10 @@ Do not truncate text in columns. The default is to not truncate the
|
||||||
columns. This option disables text truncation also in all other columns.
|
columns. This option disables text truncation also in all other columns.
|
||||||
.TP
|
.TP
|
||||||
.BR \-v , " \-\-nofsroot"
|
.BR \-v , " \-\-nofsroot"
|
||||||
Do not print a [/dir] in the SOURCE column for bind-mounts or btrfs subvolumes.
|
Do not print a [/dir] in the SOURCE column for bind mounts or btrfs subvolumes.
|
||||||
.TP
|
.TP
|
||||||
.BR \-w , " \-\-timeout \fImilliseconds\fP"
|
.BR \-w , " \-\-timeout \fImilliseconds\fP"
|
||||||
Specify an upper limit on the time for which \fB--poll\fR will block, in milliseconds.
|
Specify an upper limit on the time for which \fB\-\-poll\fR will block, in milliseconds.
|
||||||
.SH EXAMPLES
|
.SH EXAMPLES
|
||||||
.IP "\fBfindmnt \-\-fstab \-t nfs\fP"
|
.IP "\fBfindmnt \-\-fstab \-t nfs\fP"
|
||||||
Prints all NFS filesystems defined in
|
Prints all NFS filesystems defined in
|
||||||
|
@ -241,21 +242,21 @@ Prints all
|
||||||
.IR /etc/fstab
|
.IR /etc/fstab
|
||||||
filesystems where the mountpoint directory is /mnt/foo. It also prints bind mounts where /mnt/foo
|
filesystems where the mountpoint directory is /mnt/foo. It also prints bind mounts where /mnt/foo
|
||||||
is a source.
|
is a source.
|
||||||
.IP "\fBfindmnt \-\-fstab --target /mnt/foo\fP"
|
.IP "\fBfindmnt \-\-fstab \-\-target /mnt/foo\fP"
|
||||||
Prints all
|
Prints all
|
||||||
.IR /etc/fstab
|
.IR /etc/fstab
|
||||||
filesystems where the mountpoint directory is /mnt/foo.
|
filesystems where the mountpoint directory is /mnt/foo.
|
||||||
.IP "\fBfindmnt --fstab --evaluate\fP"
|
.IP "\fBfindmnt \-\-fstab \-\-evaluate\fP"
|
||||||
Prints all
|
Prints all
|
||||||
.IR /etc/fstab
|
.IR /etc/fstab
|
||||||
filesystems and converts LABEL= and UUID= tags to the real device names.
|
filesystems and converts LABEL= and UUID= tags to the real device names.
|
||||||
.IP "\fBfindmnt -n --raw --evaluate --output=target LABEL=/boot\fP"
|
.IP "\fBfindmnt \-n \-\-raw \-\-evaluate \-\-output=target LABEL=/boot\fP"
|
||||||
Prints only the mountpoint where the filesystem with label "/boot" is mounted.
|
Prints only the mountpoint where the filesystem with label "/boot" is mounted.
|
||||||
.IP "\fBfindmnt --poll --mountpoint /mnt/foo\fP"
|
.IP "\fBfindmnt \-\-poll \-\-mountpoint /mnt/foo\fP"
|
||||||
Monitors mount, unmount, remount and move on /mnt/foo.
|
Monitors mount, unmount, remount and move on /mnt/foo.
|
||||||
.IP "\fBfindmnt --poll=umount --first-only --mountpoint /mnt/foo\fP"
|
.IP "\fBfindmnt \-\-poll=umount \-\-first-only \-\-mountpoint /mnt/foo\fP"
|
||||||
Waits for /mnt/foo unmount.
|
Waits for /mnt/foo unmount.
|
||||||
.IP "\fBfindmnt --poll=remount -t ext3 -O ro\fP"
|
.IP "\fBfindmnt \-\-poll=remount \-t ext3 \-O ro\fP"
|
||||||
Monitors remounts to read-only mode on all ext3 filesystems.
|
Monitors remounts to read-only mode on all ext3 filesystems.
|
||||||
.SH ENVIRONMENT
|
.SH ENVIRONMENT
|
||||||
.IP LIBMOUNT_FSTAB=<path>
|
.IP LIBMOUNT_FSTAB=<path>
|
||||||
|
|
Loading…
Reference in New Issue