findmnt(8)

1FINDMNT(8)                  System Manager's Manual                 FINDMNT(8)
2
3
4

NAME

6       findmnt - find a filesystem
7

SYNOPSIS

9       findmnt [options]
10
11       findmnt [options] device|mountpoint
12
13       findmnt [options] [--source] device [--target] mountpoint
14

DESCRIPTION

16       findmnt  will  list  all mounted filesytems or search for a filesystem.
17       The findmnt command is able  to  search  in  /etc/fstab,  /etc/fstab.d,
18       /etc/mtab  or  /proc/self/mountinfo.   If  device  or mountpoint is not
19       given, all filesystems are shown.
20
21       The command prints all mounted filesystems in the tree-like  format  by
22       default.
23

OPTIONS

25       -h, --help
26              Print help and exit.
27
28       -s, --fstab
29              Search  in  /etc/fstab  and  /etc/fstab.d.  The output is in the
30              list format (see --list).
31
32       -m, --mtab
33              Search in /etc/mtab.  The output is  in  the  list  format  (see
34              --list).
35
36       -k, --kernel
37              Search  in /proc/self/mountinfo.  The output is in the tree-like
38              format.  This is the default.
39
40       -c, --canonicalize
41              Canonicalize all printed paths.
42
43       -d, --direction word
44              The search direction - forward or backward.
45
46       -e, --evaluate
47              Convert all tags (LABEL or UUID) to the device names.
48
49       -f, --first-only
50              Print the first matching filesystem only.
51
52       -i, --invert
53              Invert the sense of matching.
54
55       -l, --list
56              Use the list output format. This output format is  automatically
57              enabled  if  the output is restricted by -t, -O, -S or -T option
58              and the option --submounts is not used.
59
60       -v, --nofsroot
61              Do not print a [/dir] in the SOURCE column  for  bind-mounts  or
62              btrfs subvolumes.
63
64       -n, --noheadings
65              Do not print a header line.
66
67       -u, --notruncate
68              Do not truncate text in columns.  The default is to not truncate
69              the TARGET, SOURCE, UUID and LABEL columns.   This  option  dis‐
70              ables text truncation also in all other columns.
71
72       -O, --options list
73              Used  to  limit  the  set of printed filesystems.  More than one
74              option may be specified in a comma-separated list.  The  -t  and
75              -O options are cumulative in effect.  It is different from -t in
76              that each option is matched exactly; a leading no at the  begin‐
77              ning  of  one option does not negate the rest.  For more details
78              see mount(8).
79
80       -o, --output list
81              Define output columns.  Currently supported are SOURCE,  TARGET,
82              FSTYPE,  OPTIONS,  VFS-OPTIONS, FS-OPTIONS, LABEL and UUID.  The
83              TARGET column contains tree formatting if the  --list  or  --raw
84              options are not specified.
85
86       -r, --raw
87              Use raw output format.
88
89       -a, --ascii
90              Use ascii characters for tree formatting.
91
92       -t, --types list
93              Used  to  limit  the  set of printed filesystems.  More than one
94              type may be specified in a comma-separated list.   The  list  of
95              filesystem types can be prefixed with no to specify the filesys‐
96              tem types on which no action should be taken.  For more  details
97              see mount(8).
98
99       -R, --submounts
100              Print  recursively  all  submounts for the selected filesystems.
101              The restrictions defined by options -t, -O, -S, -T and  --direc‐
102              tion  are  not  applied  to  submounts. All submounts are always
103              printed in tree-like order. The  option  enables  the  tree-like
104              output  format  by default. This option has no effect for --mtab
105              or --fstab.
106
107       -S, --source spec
108              Explicitly define  the  mount  source.   Supported  are  device,
109              LABEL= or UUID=.
110
111       -T, --target dir
112              Explicitly define the mount target (mountpoint directory).
113

EXAMPLES

115       findmnt --fstab -t nfs
116              Prints all nfs filesystems defined in /etc/fstab.
117
118       findmnt --fstab /mnt/foo
119              Prints all /etc/fstab filesystems where the mountpoint directory
120              is /mnt/foo.  It also prints bind mounts  where  /mnt/foo  is  a
121              source.
122
123       findmnt --fstab --target /mnt/foo
124              Prints all /etc/fstab filesystems where the mountpoint directory
125              is /mnt/foo.
126
127       findmnt --fstab --evaluate
128              Prints all /etc/fstab filesystems and converts LABEL= and  UUID=
129              tags to the real device names.
130
131       findmnt -n --raw --evaluate --output=target LABEL=/boot
132              Prints  only  the  mountpoint  where  the  filesystem with label
133              "/boot" is mounted.
134

AUTHORS

136       Karel Zak <kzak@redhat.com>
137

AVAILABILITY

142       The findmnt command is part of the util-linux package and is  available
143       from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
144
145
146
147Version 1.0                        Apr 2010                         FINDMNT(8)