findmnt man page on ElementaryOS

Man page or keyword search:  
man Server   4994 pages
apropos Keyword Search (all sections)
Output format
ElementaryOS logo
[printable version]

FINDMNT(8)		     System Administration		    FINDMNT(8)

       findmnt - find a filesystem

       findmnt [options]

       findmnt [options] device|mountpoint

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

       findmnt	will  list  all mounted filesytems or search for a filesystem.
       The findmnt command is able  to	search	in  /etc/fstab,	 /etc/fstab.d,
       /etc/mtab  or  /proc/self/mountinfo.   If  device  or mountpoint is not
       given, all filesystems are shown.

       The command prints all mounted filesystems in the tree-like  format  by

       -h, --help
	      Print help and exit.

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

       -m, --mtab
	      Search in /etc/mtab.  The output is  in  the  list  format  (see

       -k, --kernel
	      Search  in /proc/self/mountinfo.	The output is in the tree-like
	      format.  This is the default.

       -c, --canonicalize
	      Canonicalize all printed paths.

       -d, --direction word
	      The search direction - forward or backward.

       -e, --evaluate
	      Convert all tags (LABEL or UUID) to the device names.

       -f, --first-only
	      Print the first matching filesystem only.

       -i, --invert
	      Invert the sense of matching.

       -l, --list
	      Use the list output format. This output format is	 automatically
	      enabled  if  the output is restricted by -t, -O, -S or -T option
	      and the option --submounts is not used.

       -v, --nofsroot
	      Do not print a [/dir] in the SOURCE column  for  bind-mounts  or
	      btrfs subvolumes.

       -n, --noheadings
	      Do not print a header line.

       -u, --notruncate
	      Do not truncate text in columns.	The default is to not truncate
	      the TARGET, SOURCE, UUID and LABEL columns.   This  option  dis‐
	      ables text truncation also in all other columns.

       -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 of  one
	      option does not negate the rest.	For more details see mount(8).

       -o, --output list
	      Define  output columns.  Currently supported are ACTION, SOURCE,
	      FS-OPTIONS,  LABEL  and  UUID.   The TARGET column contains tree
	      formatting if the --list or --raw options are not specified.

       -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  informa‐
	      tion  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

		     available for umount and move actions

		     available for umount and remount actions

       -r, --raw
	      Use raw output format.

       -a, --ascii
	      Use ascii characters for tree formatting.

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

       -R, --submounts
	      Print  recursively  all  submounts for the selected filesystems.
	      The restrictions defined by options -t, -O, -S, -T and  --direc‐
	      tion  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.

       -S, --source spec
	      Explicitly define	 the  mount  source.   Supported  are  device,
	      LABEL= and UUID=.

       -T, --target dir
	      Explicitly define the mount target (mountpoint directory).

       -w, --timeout milliseconds
	      Specify  an upper limit on the time for which --poll will block,
	      in milliseconds.

       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

       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 --target /mnt/foo
	      Monitors mount, umount, remount and move on /mnt/foo.

       findmnt --poll=umount --first-only --target /mnt/foo
	      Waits for /mnt/foo umount.

       findmnt --poll=remount -t ext3 -O ro
	      Monitors remounts to read-only mode on all ext3 filesystems.

       Karel Zak <>

       mount(8), fstab(5)

       The  findmnt command is part of the util-linux package and is available

util-linux			  April 2010			    FINDMNT(8)

List of man pages available for ElementaryOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net