Provided by: mount_2.27.1-6ubuntu3.10_amd64 bug

NAME

       findmnt - find a filesystem

SYNOPSIS

       findmnt [options]

       findmnt [options] device|mountpoint

       findmnt [options] [--source] device [--target|--mountpoint] mountpoint

DESCRIPTION

       findmnt  will list all mounted filesytems 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,  maj:min,  filesystem LABEL or UUID, or
       partition PARTUUID or PARTLABEL.  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 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 column 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 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.

       -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 (see --list).

       -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 "+" prefix.

       -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
              +list (e.g. findmnt -o +PROPAGATION).

       -P, --pairs
              Use key="value" output format.  All potentially unsafe characters  are  hex-escaped
              (\x<code>).

       -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(8).  The poll mode allows to use 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

       -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>).

       -S, --source spec
              Explicitly  define the mount source.  Supported are device, maj:min, LABEL=, UUID=,
              PARTLABEL= or PARTUUID=.

       -s, --fstab
              Search in /etc/fstab.  The output is in the list format (see --list).

       -T, --target path
              Define the mount target. If the path is not a mountpoint file  or  directory,  then
              findmnt  checks  path elements in reverse order to get the mountpoint (this feature
              is supported only if search in kernel files  and  unsupported  for  --fstab).  It's
              recommended to use the option --mountpoint when checks of path elements is 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).

       -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.

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.

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

AUTHORS

       Karel Zak <kzak@redhat.com>

SEE ALSO

       mount(8), fstab(5)

AVAILABILITY

       The  findmnt  command  is  part  of  the  util-linux  package  and   is   available   from
       ftp://ftp.kernel.org/pub/linux/utils/util-linux/.