-.TH FINDMNT 8 "June 2015" "util-linux" "System Administration"
+.TH FINDMNT 8 "May 2018" "util-linux" "System Administration"
.SH NAME
findmnt \- find a filesystem
.SH SYNOPSIS
.B findmnt
[options]
.RB [ \-\-source ]
-.IR device
+.I device
.RB [ \-\-target | \-\-mountpoint ]
-.IR mountpoint
+.I mountpoint
.SH DESCRIPTION
.B findmnt
-will list all mounted filesytems or search for a filesystem. The
+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
+.I /etc/mtab
or
.IR /proc/self/mountinfo .
If
-.IR device
+.I device
or
-.IR mountpoint
+.I mountpoint
is not given, all filesystems are shown.
.PP
The device may be specified by device name, major:minor numbers,
.BR \-k , " \-\-kernel"
Search in
.IR /proc/self/mountinfo .
-The output is in the tree-like format. This is the default.
+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
.BR \-m , " \-\-mtab"
Search in
.IR /etc/mtab .
-The output is in the list format (see \fB\-\-list\fP).
+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
.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
+.B TARGET
column contains tree formatting if the
.B \-\-list
or
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).
+specified in the format \fI+list\fP (e.g., \fBfindmnt \-o +PROPAGATION\fP).
+.TP
+.B \-\-output\-all
+Output almost all available columns. The columns that require
+.B \-\-poll
+are not included.
.TP
.BR \-P , " \-\-pairs"
Use key="value" output format. All potentially unsafe characters are hex-escaped (\\x<code>).
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) .
+.BR findmnt (8).
The poll mode allows to use extra columns:
.RS
.TP
available for umount and remount actions
.RE
.TP
+.B \-\-pseudo
+Print only pseudo filesystems.
+.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
.BR \-r , " \-\-raw"
Use raw output format. All potentially unsafe characters are hex-escaped (\\x<code>).
.TP
+.B \-\-real
+Print only real filesystems.
+.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,
more details see
.BR mount (8).
.TP
+.B \-\-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.
.BR UUID ,
.BR LABEL ,
.BR PARTUUID ,
-.BR PARTLABEL
+.B PARTLABEL
columns. This option disables text truncation also in all other columns.
.TP
.BR \-v , " \-\-nofsroot"
.TP
.BR \-w , " \-\-timeout \fImilliseconds\fP"
Specify an upper limit on the time for which \fB\-\-poll\fR will block, in milliseconds.
-.SH EXAMPLES
+.TP
+.BR \-x , " \-\-verify"
+Check mount table content. The default is to verify
+.I /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
+.B \-\-verbose
+Force findmnt to print more information (\fB\-\-verify\fP only for now).
+.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 EXAMPLE
.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
+.I /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
+.I /etc/fstab
filesystems where the mountpoint directory is /mnt/foo.
.IP "\fBfindmnt \-\-fstab \-\-evaluate\fP"
Prints all
-.IR /etc/fstab
+.I /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.
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
.SH AUTHORS
.nf
Karel Zak <kzak@redhat.com>
.fi
.SH SEE ALSO
-.BR mount (8),
-.BR fstab (5)
+.BR fstab (5),
+.BR mount (8)
.SH AVAILABILITY
The findmnt command is part of the util-linux package and is available from
-ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+https://www.kernel.org/pub/linux/utils/util-linux/.
projects / thirdparty / util-linux.git / blobdiff