298 lines
9.6 KiB
Groff
298 lines
9.6 KiB
Groff
.TH FINDMNT 8 "June 2015" "util-linux" "System Administration"
|
|
.SH NAME
|
|
findmnt \- find a filesystem
|
|
.SH SYNOPSIS
|
|
.B findmnt
|
|
[options]
|
|
.sp
|
|
.B findmnt
|
|
[options]
|
|
.IR device | mountpoint
|
|
.sp
|
|
.B findmnt
|
|
[options]
|
|
.RB [ \-\-source ]
|
|
.IR device
|
|
.RB [ \-\-target | \-\-mountpoint ]
|
|
.IR mountpoint
|
|
.SH DESCRIPTION
|
|
.B findmnt
|
|
will list all mounted filesystems or search for a filesystem. The
|
|
.B \%findmnt
|
|
command is able to search in
|
|
.IR /etc/fstab ,
|
|
.IR /etc/mtab
|
|
or
|
|
.IR /proc/self/mountinfo .
|
|
If
|
|
.IR device
|
|
or
|
|
.IR mountpoint
|
|
is not given, all filesystems are shown.
|
|
.PP
|
|
The device may be specified by device name, major:minor numbers,
|
|
filesystem label or UUID, or partition label or UUID. Note that
|
|
.B \%findmnt
|
|
follows
|
|
.BR mount (8)
|
|
behavior where a device name may be interpreted
|
|
as a mountpoint (and vice versa) if the \fB\-\-target\fR, \fB\-\-mountpoint\fR or
|
|
\fB\-\-source\fR options are not specified.
|
|
.PP
|
|
The command prints all mounted filesystems in the tree-like format by default.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BR \-A , " \-\-all"
|
|
Disable all built-in filters and print all filesystems.
|
|
.TP
|
|
.BR \-a , " \-\-ascii"
|
|
Use ascii characters for tree formatting.
|
|
.TP
|
|
.BR \-b , " \-\-bytes"
|
|
Print the SIZE, USED and AVAIL columns in bytes rather than in a human-readable format.
|
|
.TP
|
|
.BR \-C , " \-\-nocanonicalize"
|
|
Do not canonicalize paths at all. This option affects the comparing of paths
|
|
and the evaluation of tags (LABEL, UUID, etc.).
|
|
.TP
|
|
.BR \-c , " \-\-canonicalize"
|
|
Canonicalize all printed paths.
|
|
.TP
|
|
.BR \-D , " \-\-df"
|
|
Imitate the output of
|
|
.BR df (1).
|
|
This option is equivalent to
|
|
.B \-o\ SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET
|
|
but excludes all pseudo filesystems.
|
|
Use \fB\-\-all\fP to print all filesystems.
|
|
.TP
|
|
.BR \-d , " \-\-direction \fIword\fP"
|
|
The search direction, either
|
|
.B forward
|
|
or
|
|
.BR backward .
|
|
.TP
|
|
.BR \-e , " \-\-evaluate"
|
|
Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) to the corresponding device names.
|
|
.TP
|
|
.BR \-F , " \-\-tab\-file \fIpath\fP"
|
|
Search in an alternative file. If used with \fB\-\-fstab\fP, \fB\-\-mtab\fP
|
|
or \fB\-\-kernel\fP, then it overrides the default paths. If specified more
|
|
than once, then tree-like output is disabled (see the \fB\-\-list\fP option).
|
|
.TP
|
|
.BR \-f , " \-\-first\-only"
|
|
Print the first matching filesystem only.
|
|
.TP
|
|
.BR \-h , " \-\-help"
|
|
Display help text and exit.
|
|
.TP
|
|
.BR \-i , " \-\-invert"
|
|
Invert the sense of matching.
|
|
.TP
|
|
.BR \-J , " \-\-json"
|
|
Use JSON output format.
|
|
.TP
|
|
.BR \-k , " \-\-kernel"
|
|
Search in
|
|
.IR /proc/self/mountinfo .
|
|
The output is in the tree-like format. This is the default. The output
|
|
contains only mount options maintained by kernel (see also \fB\-\-mtab)\fP.
|
|
.TP
|
|
.BR \-l , " \-\-list"
|
|
Use the list output format. This output format is automatically enabled if the
|
|
output is restricted by the \fB\-t\fP, \fB\-O\fP, \fB\-S\fP or \fB\-T\fP
|
|
option and the option \fB\-\-submounts\fP is not used or if more that one
|
|
source file (the option \fB\-F\fP) is specified.
|
|
.TP
|
|
.BR \-M , " \-\-mountpoint \fIpath\fP"
|
|
Explicitly define the mountpoint file or directory. See also \fB\-\-target\fP.
|
|
.TP
|
|
.BR \-m , " \-\-mtab"
|
|
Search in
|
|
.IR /etc/mtab .
|
|
The output is in the list format by default (see \fB\-\-tree\fP). The output may include user
|
|
space mount options.
|
|
.TP
|
|
.BR \-N , " \-\-task \fItid\fP"
|
|
Use alternative namespace /proc/<tid>/mountinfo rather than the default
|
|
/proc/self/mountinfo. If the option is specified more than once, then
|
|
tree-like output is disabled (see the \fB\-\-list\fP option). See also the
|
|
.BR unshare (1)
|
|
command.
|
|
.TP
|
|
.BR \-n , " \-\-noheadings"
|
|
Do not print a header line.
|
|
.TP
|
|
.BR \-O , " \-\-options \fIlist\fP"
|
|
Limit the set of printed filesystems. More than one option
|
|
may be specified in a comma-separated list. The
|
|
.B \-t
|
|
and
|
|
.B \-O
|
|
options are cumulative in effect. It is different from
|
|
.B \-t
|
|
in that each option is matched exactly; a leading
|
|
.I no
|
|
at the beginning does not have global meaning. The "no" can used for
|
|
individual items in the list. The "no" prefix interpretation can be disabled
|
|
by "+" prefix.
|
|
.TP
|
|
.BR \-o , " \-\-output \fIlist\fP"
|
|
Define output columns. See the \fB\-\-help\fP output to get a list of the
|
|
currently supported columns. The
|
|
.BR TARGET
|
|
column contains tree formatting if the
|
|
.B \-\-list
|
|
or
|
|
.B \-\-raw
|
|
options are not specified.
|
|
|
|
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).
|
|
.TP
|
|
.BR \-P , " \-\-pairs"
|
|
Use key="value" output format. All potentially unsafe characters are hex-escaped (\\x<code>).
|
|
.TP
|
|
.BR \-p , " \-\-poll\fR[\fI=list\fR]"
|
|
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
|
|
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
|
|
or \fB\-\-first\-only\fP options.
|
|
|
|
The standard columns always use the new version of the information from the
|
|
mountinfo file, except the umount action which is based on the original
|
|
information cached by
|
|
.BR findmnt (8).
|
|
The poll mode allows to use extra columns:
|
|
.RS
|
|
.TP
|
|
.B ACTION
|
|
mount, umount, move or remount action name; this column is enabled by default
|
|
.TP
|
|
.B OLD-TARGET
|
|
available for umount and move actions
|
|
.TP
|
|
.B OLD-OPTIONS
|
|
available for umount and remount actions
|
|
.RE
|
|
.TP
|
|
.BR \-R , " \-\-submounts"
|
|
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
|
|
\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
|
|
default. This option has no effect for \fB\-\-mtab\fP or \fB\-\-fstab\fP.
|
|
.TP
|
|
.BR \-r , " \-\-raw"
|
|
Use raw output format. All potentially unsafe characters are hex-escaped (\\x<code>).
|
|
.TP
|
|
.BR \-S , " \-\-source \fIspec\fP"
|
|
Explicitly define the mount source. Supported specifications are \fIdevice\fR,
|
|
\fImaj\fB:\fImin\fR, \fBLABEL=\fIlabel\fR, \fBUUID=\fIuuid\fR,
|
|
\fBPARTLABEL=\fIlabel\fR and \fBPARTUUID=\fIuuid\fR.
|
|
.TP
|
|
.BR \-s , " \-\-fstab"
|
|
Search in
|
|
.IR /etc/fstab .
|
|
The output is in the list format (see \fB\-\-list\fR).
|
|
.TP
|
|
.BR \-T , " \-\-target \fIpath\fP"
|
|
Define the mount target. If \fIpath\fR
|
|
is not a mountpoint file or directory, then
|
|
.B findmnt
|
|
checks the \fIpath\fR elements in reverse order to get the mountpoint (this feature is
|
|
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 are
|
|
unwanted and \fIpath\fR is a strictly specified mountpoint.
|
|
.TP
|
|
.BR \-t , " \-\-types \fIlist\fP"
|
|
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
|
|
prefixed with
|
|
.B no
|
|
to specify the filesystem types on which no action should be taken. For
|
|
more details see
|
|
.BR mount (8).
|
|
.TP
|
|
.BR " \-\-tree"
|
|
Enable tree-like output if possible. The options is silently ignored for
|
|
tables where is missing child-parent relation (e.g. fstab).
|
|
.TP
|
|
.BR \-U , " \-\-uniq"
|
|
Ignore filesystems with duplicate mount targets, thus effectively skipping
|
|
over-mounted mount points.
|
|
.TP
|
|
.BR \-u , " \-\-notruncate"
|
|
Do not truncate text in columns. The default is to not truncate the
|
|
.BR TARGET ,
|
|
.BR SOURCE ,
|
|
.BR UUID ,
|
|
.BR LABEL ,
|
|
.BR PARTUUID ,
|
|
.BR PARTLABEL
|
|
columns. This option disables text truncation also in all other columns.
|
|
.TP
|
|
.BR \-v , " \-\-nofsroot"
|
|
Do not print a [/dir] in the SOURCE column for bind mounts or btrfs subvolumes.
|
|
.TP
|
|
.BR \-w , " \-\-timeout \fImilliseconds\fP"
|
|
Specify an upper limit on the time for which \fB\-\-poll\fR will block, in milliseconds.
|
|
.TP
|
|
.BR \-x , " \-\-verify"
|
|
Check mount table content. The default is to verify
|
|
.IR /etc/fstab
|
|
parsability and usability. It's possible to use this option also with \fB\-\-tab\-file\fP.
|
|
It's possible to specify source (device) or target (mountpoint) to filter mount table. The option
|
|
\fB\-\-verbose\fP forces findmnt to print more details.
|
|
.TP
|
|
.BR " \-\-verbose"
|
|
Force findmnt to print more information (\fB\-\-verify\fP only for now).
|
|
.SH EXAMPLES
|
|
.IP "\fBfindmnt \-\-fstab \-t nfs\fP"
|
|
Prints all NFS filesystems defined in
|
|
.IR /etc/fstab .
|
|
.IP "\fBfindmnt \-\-fstab /mnt/foo\fP"
|
|
Prints all
|
|
.IR /etc/fstab
|
|
filesystems where the mountpoint directory is /mnt/foo. It also prints bind mounts where /mnt/foo
|
|
is a source.
|
|
.IP "\fBfindmnt \-\-fstab \-\-target /mnt/foo\fP"
|
|
Prints all
|
|
.IR /etc/fstab
|
|
filesystems where the mountpoint directory is /mnt/foo.
|
|
.IP "\fBfindmnt \-\-fstab \-\-evaluate\fP"
|
|
Prints all
|
|
.IR /etc/fstab
|
|
filesystems and converts LABEL= and UUID= tags to the real device names.
|
|
.IP "\fBfindmnt \-n \-\-raw \-\-evaluate \-\-output=target LABEL=/boot\fP"
|
|
Prints only the mountpoint where the filesystem with label "/boot" is mounted.
|
|
.IP "\fBfindmnt \-\-poll \-\-mountpoint /mnt/foo\fP"
|
|
Monitors mount, unmount, remount and move on /mnt/foo.
|
|
.IP "\fBfindmnt \-\-poll=umount \-\-first-only \-\-mountpoint /mnt/foo\fP"
|
|
Waits for /mnt/foo unmount.
|
|
.IP "\fBfindmnt \-\-poll=remount \-t ext3 \-O ro\fP"
|
|
Monitors remounts to read-only mode on all ext3 filesystems.
|
|
.SH ENVIRONMENT
|
|
.IP LIBMOUNT_FSTAB=<path>
|
|
overrides the default location of the fstab file
|
|
.IP LIBMOUNT_MTAB=<path>
|
|
overrides the default location of the mtab file
|
|
.IP LIBMOUNT_DEBUG=all
|
|
enables libmount debug output
|
|
.IP LIBSMARTCOLS_DEBUG=all
|
|
enables libsmartcols debug output
|
|
.IP LIBSMARTCOLS_DEBUG_PADDING=on
|
|
use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.
|
|
.SH AUTHORS
|
|
.nf
|
|
Karel Zak <kzak@redhat.com>
|
|
.fi
|
|
.SH SEE ALSO
|
|
.BR fstab (5),
|
|
.BR mount (8)
|
|
.SH AVAILABILITY
|
|
The findmnt command is part of the util-linux package and is available from
|
|
https://www.kernel.org/pub/linux/utils/util-linux/.
|