//po4a: entry man manual = findmnt(8) :doctype: manpage :man manual: System Administration :man source: util-linux {release-version} :page-layout: base :command: findmnt :plus: + == NAME findmnt - find a filesystem == SYNOPSIS *findmnt* [options] *findmnt* [options] _device_|_mountpoint_ *findmnt* [options] [*--source*] _device_ [*--target* _path_|*--mountpoint* _mountpoint_] == DESCRIPTION *findmnt* will list all mounted filesystems or search for a filesystem. The *findmnt* command is able to search in _/etc/fstab_, _/etc/mtab_ or _/proc/self/mountinfo_. If _device_ or _mountpoint_ is not given, all filesystems are shown. The device may be specified by device name, major:minor numbers, filesystem label or UUID, or partition label or UUID. Note that *findmnt* follows *mount*(8) behavior where a device name may be interpreted as a mountpoint (and vice versa) if the *--target*, *--mountpoint* or *--source* options are not specified. The command-line option *--target* accepts any file or directory and then *findmnt* displays the filesystem for the given path. The command prints all mounted filesystems in the tree-like format by default. == OPTIONS *-A*, *--all*:: Disable all built-in filters and print all filesystems. *-a*, *--ascii*:: Use ascii characters for tree formatting. *-b*, *--bytes*:: Print the SIZE, USED and AVAIL columns in bytes rather than in a human-readable format. *-C*, *--nocanonicalize*:: Do not canonicalize paths at all. This option affects the comparing of paths and the evaluation of tags (LABEL, UUID, etc.). *-c*, *--canonicalize*:: Canonicalize all printed paths. *-D*, *--df*:: Imitate the output of *df*(1). This option is equivalent to *-o SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET* but excludes all pseudo filesystems. Use *--all* to print all filesystems. *-d*, *--direction* _word_:: The search direction, either *forward* or *backward*. *-e*, *--evaluate*:: Convert all tags (LABEL, UUID, PARTUUID or PARTLABEL) to the corresponding device names. *-F*, *--tab-file* _path_:: Search in an alternative file. If used with *--fstab*, *--mtab* or *--kernel*, then it overrides the default paths. If specified more than once, then tree-like output is disabled (see the *--list* option). *-f*, *--first-only*:: Print the first matching filesystem only. *-h*, *--help*:: Display help text and exit. *-i*, *--invert*:: Invert the sense of matching. *-J*, *--json*:: Use JSON output format. *-k*, *--kernel*:: Search in _/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 *--mtab)*. *-l*, *--list*:: Use the list output format. This output format is automatically enabled if the output is restricted by the *-t*, *-O*, *-S* or *-T* option and the option *--submounts* is not used or if more that one source file (the option *-F*) is specified. *-M*, *--mountpoint* _path_:: Explicitly define the mountpoint file or directory. See also *--target*. *-m*, *--mtab*:: Search in _/etc/mtab_. The output is in the list format by default (see *--tree*). The output may include user space mount options. *-N*, *--task* _tid_:: Use alternative namespace _/proc//mountinfo_ rather than the default _/proc/self/mountinfo_. If the option is specified more than once, then tree-like output is disabled (see the *--list* option). See also the *unshare*(1) command. *-n*, *--noheadings*:: Do not print a header line. *-O*, *--options* _list_:: Limit the set of printed filesystems. More than one option may be specified in a comma-separated list. The *-t* and *-O* options are cumulative in effect. It is different from *-t* in that each option is matched exactly; a leading _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 "{plus}" prefix. //TRANSLATORS: Keep {plus} untranslated. *-o*, *--output* _list_:: Define output columns. See the *--help* output to get a list of the currently supported columns. The *TARGET* column contains tree formatting if the *--list* or *--raw* options are not specified. + The default list of columns may be extended if _list_ is specified in the format _{plus}list_ (e.g., *findmnt -o {plus}PROPAGATION*). //TRANSLATORS: Keep {plus} untranslated. *--output-all*:: Output almost all available columns. The columns that require *--poll* are not included. *-P*, *--pairs*:: Produce output in the form of key="value" pairs. All potentially unsafe value characters are hex-escaped (\x). The key (variable name) will be modified to contain only characters allowed for a shell variable identifiers, for example, FS_OPTIONS and USE_PCT instead of FS-OPTIONS and USE%. *-p*, *--poll*[_=list_]:: 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 *--poll* will block can be restricted with the *--timeout* or *--first-only* 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 *findmnt*. The poll mode allows using extra columns: + *ACTION*;; mount, umount, move or remount action name; this column is enabled by default *OLD-TARGET*;; available for umount and move actions *OLD-OPTIONS*;; available for umount and remount actions *--pseudo*:: Print only pseudo filesystems. *--shadow*:: Print only filesystems over-mounted by another filesystem. *-R*, *--submounts*:: Print recursively all submounts for the selected filesystems. The restrictions defined by options *-t*, *-O*, *-S*, *-T* and *--direction* 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 *--mtab* or *--fstab*. *-r*, *--raw*:: Use raw output format. All potentially unsafe characters are hex-escaped (\x). *--real*:: Print only real filesystems. *-S*, *--source* _spec_:: Explicitly define the mount source. Supported specifications are _device_, __maj__**:**_min_, **LABEL=**__label__, **UUID=**__uuid__, **PARTLABEL=**__label__ and **PARTUUID=**__uuid__. *-s*, *--fstab*:: Search in _/etc/fstab_. The output is in the list format (see *--list*). *-T*, *--target* _path_:: Define the mount target. If _path_ is not a mountpoint file or directory, then *findmnt* checks the _path_ elements in reverse order to get the mountpoint (this feature is supported only when searching in kernel files and unsupported for *--fstab*). It's recommended to use the option *--mountpoint* when checks of _path_ elements are unwanted and _path_ is a strictly specified mountpoint. *-t*, *--types* _list_:: 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 *no* to specify the filesystem types on which no action should be taken. For more details see *mount*(8). *--tree*:: Enable tree-like output if possible. The options is silently ignored for tables where is missing child-parent relation (e.g., fstab). *--shadowed*:: Print only filesystems over-mounted by another filesystem. *-U*, *--uniq*:: Ignore filesystems with duplicate mount targets, thus effectively skipping over-mounted mount points. *-u*, *--notruncate*:: Do not truncate text in columns. The default is to not truncate the *TARGET*, *SOURCE*, *UUID*, *LABEL*, *PARTUUID*, *PARTLABEL* columns. This option disables text truncation also in all other columns. *-v*, *--nofsroot*:: Do not print a [/dir] in the SOURCE column for bind mounts or btrfs subvolumes. *-w*, *--timeout* _milliseconds_:: Specify an upper limit on the time for which *--poll* will block, in milliseconds. *-x*, *--verify*:: Check mount table content. The default is to verify _/etc/fstab_ parsability and usability. It's possible to use this option also with *--tab-file*. It's possible to specify source (device) or target (mountpoint) to filter mount table. The option *--verbose* forces findmnt to print more details. *--verbose*:: Force findmnt to print more information (*--verify* only for now). *--vfs-all*:: When used with *VFS-OPTIONS* column, print all VFS (fs-independent) flags. This option is designed for auditing purposes to list also default VFS kernel mount options which are normally not listed. == ENVIRONMENT LIBMOUNT_FSTAB=:: overrides the default location of the fstab file LIBMOUNT_MTAB=:: overrides the default location of the mtab file LIBMOUNT_DEBUG=all:: enables libmount debug output LIBSMARTCOLS_DEBUG=all:: enables libsmartcols debug output LIBSMARTCOLS_DEBUG_PADDING=on:: use visible padding characters. Requires enabled LIBSMARTCOLS_DEBUG. == EXAMPLES *findmnt --fstab -t nfs*:: Prints all NFS filesystems defined in _/etc/fstab_. *findmnt --fstab /mnt/foo*:: Prints all _/etc/fstab_ filesystems where the mountpoint directory is _/mnt/foo_. It also prints bind mounts where _/mnt/foo_ is a source. *findmnt --fstab --target /mnt/foo*:: Prints all _/etc/fstab_ filesystems where the mountpoint directory is _/mnt/foo_. *findmnt --fstab --evaluate*:: Prints all _/etc/fstab_ filesystems and converts LABEL= and UUID= tags to the real device names. *findmnt -n --raw --evaluate --output=target LABEL=/boot*:: Prints only the mountpoint where the filesystem with label "/boot" is mounted. *findmnt --poll --mountpoint /mnt/foo*:: Monitors mount, unmount, remount and move on _/mnt/foo_. *findmnt --poll=umount --first-only --mountpoint /mnt/foo*:: Waits for _/mnt/foo_ unmount. *findmnt --poll=remount -t ext3 -O ro*:: Monitors remounts to read-only mode on all ext3 filesystems. == AUTHORS mailto:kzak@redhat.com[Karel Zak] == SEE ALSO *fstab*(5), *mount*(8) include::man-common/bugreports.adoc[] include::man-common/footer.adoc[] ifdef::translation[] include::man-common/translation.adoc[] endif::[]