234 lines
9.9 KiB
Plaintext
234 lines
9.9 KiB
Plaintext
//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/<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 *--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<code>). 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<code>).
|
|
|
|
*--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=<path>::
|
|
overrides the default location of the fstab file
|
|
|
|
LIBMOUNT_MTAB=<path>::
|
|
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::[]
|