diff options
Diffstat (limited to 'misc-utils/findmnt.8')
| -rw-r--r-- | misc-utils/findmnt.8 | 217 |
1 files changed, 217 insertions, 0 deletions
diff --git a/misc-utils/findmnt.8 b/misc-utils/findmnt.8 new file mode 100644 index 0000000..2072c52 --- /dev/null +++ b/misc-utils/findmnt.8 @@ -0,0 +1,217 @@ +.\" -*- 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 device may be specified by device name, maj:min, filesystem LABEL or UUID +or partition PARTUUID or PARTLABEL. Note that device name may be interpreted +as mountpoint (and vice versa) if --target or --source options are not +specified. +.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 \fB\-\-list\fP). +.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\-A, \-\-all\fP" +Disable all built-in filters and print all filesystems. +.IP "\fB\-a, \-\-ascii\fP" +Use ascii characters for tree formatting. +.IP "\fB\-c, \-\-canonicalize\fP" +Canonicalize all printed paths. +.IP "\fB\-D, \-\-df\fP" +Imitate the output of df(1). This option is equivalent to +"-o SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET", but excludes all +pseudo filesystem. Use \fB\-\-all\fP to print all filesystems. +.IP "\fB\-d, \-\-direction \fIword\fP" +The search direction - +.IR forward +or +.IR backward . +.IP "\fB\-e, \-\-evaluate\fP" +Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) 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, if specified more than +once, then tree-like output is disabled (see the \fB\-\-list\fP option). +.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 or if more that one +source file (the option \fB\-F\fP) is specified. +.IP "\fB\-v, \-\-nofsroot\fP" +Do not print a [/dir] in the SOURCE column for bind-mounts or btrfs subvolumes. +.IP "\fB\-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 +.BR unshare (1) +command. +.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 , +.BR LABEL , +.BR PARTUUID , +.BR PARTLABEL +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. See the \fB\-\-help\fP output to get list of the +currently supported columns. 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\-P, \-\-pairs\fP" +Use key="value" output format. All potentially unsafe characters are hex-escaped (\\x<code>). +.IP "\fB\-r, \-\-raw\fP" +Use raw output format. All potentially unsafe characters are hex-escaped (\\x<code>). +.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, \fImaj:min\fR, +\fILABEL=\fR, \fIUUID=\fR, \fIPARTLABEL=\fR or \fIPARTUUID=\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/. |