misc-utils/findmnt.8

   1 .TH FINDMNT 8 "June 2015" "util-linux" "System Administration"
   2 .SH NAME
   3 findmnt \- find a filesystem
   4 .SH SYNOPSIS
   5 .B findmnt
   6 [options]
   7 .sp
   8 .B findmnt
   9 [options]
  10 .IR device | mountpoint
  11 .sp
  12 .B findmnt
  13 [options]
  14 .RB [ \-\-source ]
  15 .IR device
  16 .RB [ \-\-target | \-\-mountpoint ]
  17 .IR mountpoint
  18 .SH DESCRIPTION
  19 .B findmnt
  20 will list all mounted filesystems or search for a filesystem.  The
  21 .B \%findmnt
  22 command is able to search in
  23 .IR /etc/fstab ,
  24 .IR /etc/mtab
  25 or
  26 .IR /proc/self/mountinfo .
  27 If
  28 .IR device
  29 or
  30 .IR mountpoint
  31 is not given, all filesystems are shown.
  32 .PP
  33 The device may be specified by device name, major:minor numbers,
  34 filesystem label or UUID, or partition label or UUID.  Note that
  35 .B \%findmnt
  36 follows
  37 .BR mount (8)
  38 behavior where a device name may be interpreted
  39 as a mountpoint (and vice versa) if the \fB\-\-target\fR, \fB\-\-mountpoint\fR or
  40 \fB\-\-source\fR options are not specified.
  41 .PP
  42 The command prints all mounted filesystems in the tree-like format by default.
  43 .SH OPTIONS
  44 .TP
  45 .BR \-A , " \-\-all"
  46 Disable all built-in filters and print all filesystems.
  47 .TP
  48 .BR \-a , " \-\-ascii"
  49 Use ascii characters for tree formatting.
  50 .TP
  51 .BR \-b , " \-\-bytes"
  52 Print the SIZE, USED and AVAIL columns in bytes rather than in a human-readable format.
  53 .TP
  54 .BR \-C , " \-\-nocanonicalize"
  55 Do not canonicalize paths at all.  This option affects the comparing of paths
  56 and the evaluation of tags (LABEL, UUID, etc.).
  57 .TP
  58 .BR \-c , " \-\-canonicalize"
  59 Canonicalize all printed paths.
  60 .TP
  61 .BR \-D , " \-\-df"
  62 Imitate the output of
  63 .BR df (1).
  64 This option is equivalent to
  65 .B \-o\ SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET
  66 but excludes all pseudo filesystems.
  67 Use \fB\-\-all\fP to print all filesystems.
  68 .TP
  69 .BR \-d , " \-\-direction \fIword\fP"
  70 The search direction, either
  71 .B forward
  72 or
  73 .BR backward .
  74 .TP
  75 .BR \-e , " \-\-evaluate"
  76 Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) to the corresponding device names.
  77 .TP
  78 .BR \-F , " \-\-tab\-file \fIpath\fP"
  79 Search in an alternative file.  If used with \fB\-\-fstab\fP, \fB\-\-mtab\fP
  80 or \fB\-\-kernel\fP, then it overrides the default paths.  If specified more
  81 than once, then tree-like output is disabled (see the \fB\-\-list\fP option).
  82 .TP
  83 .BR \-f , " \-\-first\-only"
  84 Print the first matching filesystem only.
  85 .TP
  86 .BR \-h , " \-\-help"
  87 Display help text and exit.
  88 .TP
  89 .BR \-i , " \-\-invert"
  90 Invert the sense of matching.
  91 .TP
  92 .BR \-J , " \-\-json"
  93 Use JSON output format.
  94 .TP
  95 .BR \-k , " \-\-kernel"
  96 Search in
  97 .IR /proc/self/mountinfo .
  98 The output is in the tree-like format.  This is the default.  The output
  99 contains only mount options maintained by kernel (see also \fB\-\-mtab)\fP.
 100 .TP
 101 .BR \-l , " \-\-list"
 102 Use the list output format.  This output format is automatically enabled if the
 103 output is restricted by the \fB\-t\fP, \fB\-O\fP, \fB\-S\fP or \fB\-T\fP
 104 option and the option \fB\-\-submounts\fP is not used or if more that one
 105 source file (the option \fB\-F\fP) is specified.
 106 .TP
 107 .BR \-M , " \-\-mountpoint \fIpath\fP"
 108 Explicitly define the mountpoint file or directory.  See also \fB\-\-target\fP.
 109 .TP
 110 .BR \-m , " \-\-mtab"
 111 Search in
 112 .IR /etc/mtab .
 113 The output is in the list format by default (see \fB\-\-tree\fP).  The output may include user
 114 space mount options.
 115 .TP
 116 .BR \-N , " \-\-task \fItid\fP"
 117 Use alternative namespace /proc/<tid>/mountinfo rather than the default
 118 /proc/self/mountinfo.  If the option is specified more than once, then
 119 tree-like output is disabled (see the \fB\-\-list\fP option).  See also the
 120 .BR unshare (1)
 121 command.
 122 .TP
 123 .BR \-n , " \-\-noheadings"
 124 Do not print a header line.
 125 .TP
 126 .BR \-O , " \-\-options \fIlist\fP"
 127 Limit the set of printed filesystems.  More than one option
 128 may be specified in a comma-separated list.  The
 129 .B \-t
 130 and
 131 .B \-O
 132 options are cumulative in effect.  It is different from
 133 .B \-t
 134 in that each option is matched exactly; a leading
 135 .I no
 136 at the beginning does not have global meaning.  The "no" can used for
 137 individual items in the list.  The "no" prefix interpretation can be disabled
 138 by "+" prefix.
 139 .TP
 140 .BR \-o , " \-\-output \fIlist\fP"
 141 Define output columns.  See the \fB\-\-help\fP output to get a list of the
 142 currently supported columns.  The
 143 .BR TARGET
 144 column contains tree formatting if the
 145 .B \-\-list
 146 or
 147 .B \-\-raw
 148 options are not specified.
 149
 150 The default list of columns may be extended if \fIlist\fP is
 151 specified in the format \fI+list\fP (e.g. \fBfindmnt \-o +PROPAGATION\fP).
 152 .TP
 153 .BR \-P , " \-\-pairs"
 154 Use key="value" output format.  All potentially unsafe characters are hex-escaped (\\x<code>).
 155 .TP
 156 .BR \-p , " \-\-poll\fR[\fI=list\fR]"
 157 Monitor changes in the /proc/self/mountinfo file.  Supported actions are: mount,
 158 umount, remount and move.  More than one action may be specified in a
 159 comma-separated list.  All actions are monitored by default.
 160
 161 The time for which \fB\-\-poll\fR will block can be restricted with the \fB\-\-timeout\fP
 162 or \fB\-\-first\-only\fP options.
 163
 164 The standard columns always use the new version of the information from the
 165 mountinfo file, except the umount action which is based on the original
 166 information cached by
 167 .BR findmnt (8).
 168 The poll mode allows to use extra columns:
 169 .RS
 170 .TP
 171 .B ACTION
 172 mount, umount, move or remount action name; this column is enabled by default
 173 .TP
 174 .B OLD-TARGET
 175 available for umount and move actions
 176 .TP
 177 .B OLD-OPTIONS
 178 available for umount and remount actions
 179 .RE
 180 .TP
 181 .BR \-R , " \-\-submounts"
 182 Print recursively all submounts for the selected filesystems.  The restrictions
 183 defined by options \fB\-t\fP, \fB\-O\fP, \fB\-S\fP, \fB\-T\fP and
 184 \fB\%\-\-direction\fP are not applied to submounts.  All submounts are always
 185 printed in tree-like order.  The option enables the tree-like output format by
 186 default.  This option has no effect for \fB\-\-mtab\fP or \fB\-\-fstab\fP.
 187 .TP
 188 .BR \-r , " \-\-raw"
 189 Use raw output format.  All potentially unsafe characters are hex-escaped (\\x<code>).
 190 .TP
 191 .BR \-S , " \-\-source \fIspec\fP"
 192 Explicitly define the mount source.  Supported specifications are \fIdevice\fR,
 193 \fImaj\fB:\fImin\fR, \fBLABEL=\fIlabel\fR, \fBUUID=\fIuuid\fR,
 194 \fBPARTLABEL=\fIlabel\fR and \fBPARTUUID=\fIuuid\fR.
 195 .TP
 196 .BR \-s , " \-\-fstab"
 197 Search in
 198 .IR /etc/fstab .
 199 The output is in the list format (see \fB\-\-list\fR).
 200 .TP
 201 .BR \-T , " \-\-target \fIpath\fP"
 202 Define the mount target.  If \fIpath\fR
 203 is not a mountpoint file or directory, then
 204 .B findmnt
 205 checks the \fIpath\fR elements in reverse order to get the mountpoint (this feature is
 206 supported only when searching in kernel files and unsupported for \fB\-\-fstab\fP).  It's
 207 recommended to use the option \fB\-\-mountpoint\fR when checks of \fIpath\fR elements are
 208 unwanted and \fIpath\fR is a strictly specified mountpoint.
 209 .TP
 210 .BR \-t , " \-\-types \fIlist\fP"
 211 Limit the set of printed filesystems.  More than one type may be
 212 specified in a comma-separated list.  The list of filesystem types can be
 213 prefixed with
 214 .B no
 215 to specify the filesystem types on which no action should be taken.  For
 216 more details see
 217 .BR mount (8).
 218 .TP
 219 .BR " \-\-tree"
 220 Enable tree-like output if possible.  The options is silently ignored for
 221 tables where is missing child-parent relation (e.g. fstab).
 222 .TP
 223 .BR \-U , " \-\-uniq"
 224 Ignore filesystems with duplicate mount targets, thus effectively skipping
 225 over-mounted mount points.
 226 .TP
 227 .BR \-u , " \-\-notruncate"
 228 Do not truncate text in columns.  The default is to not truncate the
 229 .BR TARGET ,
 230 .BR SOURCE ,
 231 .BR UUID ,
 232 .BR LABEL ,
 233 .BR PARTUUID ,
 234 .BR PARTLABEL
 235 columns.  This option disables text truncation also in all other columns.
 236 .TP
 237 .BR \-v , " \-\-nofsroot"
 238 Do not print a [/dir] in the SOURCE column for bind mounts or btrfs subvolumes.
 239 .TP
 240 .BR \-w , " \-\-timeout \fImilliseconds\fP"
 241 Specify an upper limit on the time for which \fB\-\-poll\fR will block, in milliseconds.
 242 .TP
 243 .BR \-x , " \-\-verify"
 244 Check mount table content. The default is to verify
 245 .IR /etc/fstab
 246 parsability and usability. It's possible to use this option also with \fB\-\-tab\-file\fP.
 247 It's possible to specify source (device) or target (mountpoint) to filter mount table. The option
 248 \fB\-\-verbose\fP forces findmnt to print more details.
 249 .TP
 250 .BR " \-\-verbose"
 251 Force findmnt to print more information (\fB\-\-verify\fP only for now).
 252 .SH EXAMPLES
 253 .IP "\fBfindmnt \-\-fstab \-t nfs\fP"
 254 Prints all NFS filesystems defined in
 255 .IR /etc/fstab .
 256 .IP "\fBfindmnt \-\-fstab /mnt/foo\fP"
 257 Prints all
 258 .IR /etc/fstab
 259 filesystems where the mountpoint directory is /mnt/foo.  It also prints bind mounts where /mnt/foo
 260 is a source.
 261 .IP "\fBfindmnt \-\-fstab \-\-target /mnt/foo\fP"
 262 Prints all
 263 .IR /etc/fstab
 264 filesystems where the mountpoint directory is /mnt/foo.
 265 .IP "\fBfindmnt \-\-fstab \-\-evaluate\fP"
 266 Prints all
 267 .IR /etc/fstab
 268 filesystems and converts LABEL= and UUID= tags to the real device names.
 269 .IP "\fBfindmnt \-n \-\-raw \-\-evaluate \-\-output=target LABEL=/boot\fP"
 270 Prints only the mountpoint where the filesystem with label "/boot" is mounted.
 271 .IP "\fBfindmnt \-\-poll \-\-mountpoint /mnt/foo\fP"
 272 Monitors mount, unmount, remount and move on /mnt/foo.
 273 .IP "\fBfindmnt \-\-poll=umount \-\-first-only \-\-mountpoint /mnt/foo\fP"
 274 Waits for /mnt/foo unmount.
 275 .IP "\fBfindmnt \-\-poll=remount \-t ext3 \-O ro\fP"
 276 Monitors remounts to read-only mode on all ext3 filesystems.
 277 .SH ENVIRONMENT
 278 .IP LIBMOUNT_FSTAB=<path>
 279 overrides the default location of the fstab file
 280 .IP LIBMOUNT_MTAB=<path>
 281 overrides the default location of the mtab file
 282 .IP LIBMOUNT_DEBUG=all
 283 enables libmount debug output
 284 .IP LIBSMARTCOLS_DEBUG=all
 285 enables libsmartcols debug output
 286 .IP LIBSMARTCOLS_DEBUG_PADDING=on
 287 use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG.
 288 .SH AUTHORS
 289 .nf
 290 Karel Zak <kzak@redhat.com>
 291 .fi
 292 .SH SEE ALSO
 293 .BR fstab (5),
 294 .BR mount (8)
 295 .SH AVAILABILITY
 296 The findmnt command is part of the util-linux package and is available from
 297 https://www.kernel.org/pub/linux/utils/util-linux/.