206 lines
6.3 KiB
Groff
206 lines
6.3 KiB
Groff
.\" -*- nroff -*-
|
|
.TH FINDMNT 8 "April 2010" "util-linux" "System Administration"
|
|
.SH NAME
|
|
findmnt \- find a filesystem
|
|
.SH SYNOPSIS
|
|
.B findmnt
|
|
.RB [ options ]
|
|
.sp
|
|
.B findmnt
|
|
.RB [ options ]
|
|
.IR device | mountpoint
|
|
.sp
|
|
.B findmnt
|
|
.RB [ options ]
|
|
.RB [ \--source ]
|
|
.IR device
|
|
.RB [ \--target ]
|
|
.IR mountpoint
|
|
.SH DESCRIPTION
|
|
.B findmnt
|
|
will list all mounted filesytems 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 command prints all mounted filesystems in the tree-like format by default.
|
|
.SH OPTIONS
|
|
.IP "\fB\-h, \-\-help\fP"
|
|
Print help and exit.
|
|
.IP "\fB\-s, \-\-fstab\fP"
|
|
Search in
|
|
.IR /etc/fstab .
|
|
The output is in the list format (see --list).
|
|
.IP "\fB\-m, \-\-mtab\fP"
|
|
Search in
|
|
.IR /etc/mtab .
|
|
The output is in the list format (see --list).
|
|
.IP "\fB\-k, \-\-kernel\fP"
|
|
Search in
|
|
.IR /proc/self/mountinfo .
|
|
The output is in the tree-like format. This is the default.
|
|
.IP "\fB\-c, \-\-canonicalize\fP"
|
|
Canonicalize all printed paths.
|
|
.IP "\fB\-d, \-\-direction \fIword\fP"
|
|
The search direction -
|
|
.IR forward
|
|
or
|
|
.IR backward .
|
|
.IP "\fB\-e, \-\-evaluate\fP"
|
|
Convert all tags (LABEL or UUID) to the device names.
|
|
.IP "\fB\-F, \-\-tab\-file \fIpath\fP"
|
|
Search in an alternative file, if used with \fB\-\-fstab\fP, \fB\-\-mtab\fP
|
|
or \fB\-\-kernel\fP then overwrites the default paths.
|
|
.IP "\fB\-f, \-\-first\-only\fP"
|
|
Print the first matching filesystem only.
|
|
.IP "\fB\-i, \-\-invert\fP"
|
|
Invert the sense of matching.
|
|
.IP "\fB\-l, \-\-list\fP"
|
|
Use the list output format. This output format is automatically enabled if the
|
|
output is restricted by \fB\-t\fP, \fB\-O\fP, \fB\-S\fP or \fB\-T\fP
|
|
option and the option \fB\-\-submounts\fP is not used.
|
|
.IP "\fB\-v, \-\-nofsroot\fP"
|
|
Do not print a [/dir] in the SOURCE column for bind-mounts or btrfs subvolumes.
|
|
.IP "\fB\-n, \-\-noheadings\fP"
|
|
Do not print a header line.
|
|
.IP "\fB\-u, \-\-notruncate\fP"
|
|
Do not truncate text in columns. The default is to not truncate the
|
|
.BR TARGET ,
|
|
.BR SOURCE ,
|
|
.BR UUID
|
|
and
|
|
.BR LABEL
|
|
columns. This option disables text truncation also in all other columns.
|
|
.IP "\fB\-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" could used for
|
|
individual items in the list. The "no" prefix interpratation could be disabled
|
|
by "+" prefix.
|
|
.IP "\fB\-o, \-\-output \fIlist\fP"
|
|
Define output columns. Currently supported are
|
|
.BR ACTION,
|
|
.BR SOURCE ,
|
|
.BR TARGET ,
|
|
.BR OLD-TARGET,
|
|
.BR FSTYPE ,
|
|
.BR OPTIONS ,
|
|
.BR OLD-OPTIONS,
|
|
.BR VFS-OPTIONS ,
|
|
.BR FS-OPTIONS ,
|
|
.BR LABEL
|
|
and
|
|
.BR UUID .
|
|
The
|
|
.BR TARGET
|
|
column contains tree formatting if the
|
|
.B \-\-list
|
|
or
|
|
.B \-\-raw
|
|
options are not specified.
|
|
.IP "\fB\-p, \-\-poll\fR[\fI=list\fR]\fP"
|
|
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
|
|
.IP "\fB\-r, \-\-raw\fP"
|
|
Use raw output format.
|
|
.IP "\fB\-a, \-\-ascii\fP"
|
|
Use ascii characters for tree formatting.
|
|
.IP "\fB\-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
|
|
.I no
|
|
to specify the filesystem types on which no action should be taken. For
|
|
more details see
|
|
.BR mount (8).
|
|
.IP "\fB\-R, \-\-submounts\fP"
|
|
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.
|
|
.IP "\fB\-S, \-\-source \fIspec\fP"
|
|
Explicitly define the mount source. Supported are \fIdevice\fR, \fILABEL=\fR and \fIUUID=\fR.
|
|
.IP "\fB\-T, \-\-target \fIdir\fP"
|
|
Explicitly define the mount target (mountpoint directory).
|
|
.IP "\fB\-w, \-\-timeout \fImilliseconds\fP"
|
|
Specify an upper limit on the time for which \fB--poll\fR will block, in milliseconds.
|
|
.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 --target /mnt/foo\fP"
|
|
Monitors mount, umount, remount and move on /mnt/foo.
|
|
.IP "\fBfindmnt --poll=umount --first-only --target /mnt/foo\fP"
|
|
Waits for /mnt/foo umount.
|
|
.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=0xffff
|
|
enables debug output
|
|
.SH AUTHORS
|
|
.nf
|
|
Karel Zak <kzak@redhat.com>
|
|
.fi
|
|
.SH SEE ALSO
|
|
.BR mount (8),
|
|
.BR fstab (5)
|
|
.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/.
|