OS Manuals

/usr/bin/findmnt

Find mount from util-linux

From findmnt 2.42.4-r2 (os), captured 2026-11-05 by running findmnt --help (exit 0). permalink

Usage:
 findmnt [options]
 findmnt [options] <device> | <mountpoint>
 findmnt [options] <device> <mountpoint>
 findmnt [options] [--source <device>] [--target <path> | --mountpoint <dir>]

Find a (mounted) filesystem.

Data sources:
 -F, --tab-file <path>  alternative file for -s, -m or -k options
 -m, --mtab             search in table of mounted filesystems
                          (includes user space mount options)
 -k                     an alias for '--kernel=mountinfo'
 --kernel[=<method>]    search in kernel mount table (default behavior);
                          <method> is mountinfo or listmount
 -N, --task <tid>       use alternative namespace (/proc/<tid>/mountinfo file)
 -p, --poll[=<list>]    monitor changes in table of mounted filesystems
 -s, --fstab            search in static table of filesystems

Data filters:
 -A, --all              disable all built-in filters, print all filesystems
 -d, --direction <word> direction of search, 'forward' or 'backward'
 -f, --first-only       print the first found filesystem only
 -i, --invert           invert the sense of matching
     --id <num>         filter by mount node ID
     --uniq-id <num>    filter by mount node 64-bit ID (requires --kernel=listmount)
     --pseudo           print only pseudo-filesystems
 -Q, --filter <expr>    apply display filter
 -M, --mountpoint <dir> the mountpoint directory
     --shadowed         print only filesystems over-mounted by another filesystem
 -R, --submounts        print all submounts for the matching filesystems
     --real             print only real filesystems
 -S, --source <string>  the device to mount (by name, maj:min,
                          LABEL=, UUID=, PARTUUID=, PARTLABEL=)
 -T, --target <path>    the path to the filesystem to use
 -t, --types <list>     limit the set of filesystems by FS types
 -U, --uniq             ignore filesystems with duplicate target

Options:
 -a, --ascii            use ASCII chars for tree formatting
 -b, --bytes            print sizes in bytes rather than in human readable format
 -C, --nocanonicalize   don't canonicalize when comparing paths
 -c, --canonicalize     canonicalize printed paths
 -D, --df               imitate the output of df(1)
 -e, --evaluate         convert tags (LABEL,UUID,PARTUUID,PARTLABEL)
                          to device names
     --hyperlink[=<when>]
                        print paths as hyperlinks (always|never|auto)
 -I, --dfi              imitate the output of df(1) with -i option
 -J, --json             use JSON output format
 -l, --list             use list format output
 -n, --noheadings       don't print column headings
 -O, --options <list>   limit the set of filesystems by mount options
 -o, --output <list>    output columns (see --list-columns)
     --output-all       output all available columns
 -P, --pairs            use key="value" output format
 -r, --raw              use raw output format
     --tree             enable tree format output if possible
 -u, --notruncate       don't truncate text in columns
 -v, --nofsroot         don't print [/dir] for bind or btrfs mounts
 -w, --timeout <num>    upper limit in milliseconds that --poll will block
 -y, --shell            use column names to be usable as shell variable identifiers

 -x, --verify           verify mount table content (default is fstab)
     --verbose          print more details
     --vfs-all          print all VFS options

 -H, --list-columns     list the available columns
 -h, --help             display this help
 -V, --version          display version

For more details see findmnt(8).
Options (50)
OptionDescriptionSource
-F, --tab-file pathalternative file for -s, -m or -k optionshelp + man
-m, --mtabsearch in table of mounted filesystems (includes user space mount options)help + man
-k methodReads information about filesystems from the kernel.help + man
--kernel methodsearch in kernel mount table (default behavior);help
-N, --task tidUse alternative namespace /proc/<tid>/mountinfo rather than the default /proc/self/mountinfo.help + man
-p, --poll listMonitor changes in the /proc/self/mountinfo file.help + man
-s, --fstabsearch in static table of filesystemshelp + man
-A, --allDisable all built-in filters and print all filesystems.help + man
-f, --first-onlyPrint the first matching filesystem only.help + man
-i, --invertInvert the sense of matching.help + man
--id numSelect a filesystem using the mount node ID.help + man
--uniq-id numSelect a filesystem using the mount node 64-bit ID, use with --kernel=listmount option.help + man
--pseudoPrint only pseudo filesystems.help + man
-Q, --filter exprPrint only the filesystems that meet the conditions specified by the expr.help + man
--shadowedPrint only filesystems that are over-mounted by another filesystem.help + man
-R, --submountsPrint recursively all submounts for the selected filesystems.help + man
--realPrint only real filesystems.help + man
-S, --source stringthe device to mount (by name, maj:min, LABEL=, UUID=, PARTUUID=, PARTLABEL=)help + man
-T, --target paththe path to the filesystem to usehelp + man
-t, --types listlimit the set of filesystems by FS typeshelp + man
-U, --uniqIgnore filesystems with duplicate mount targets, thus effectively skipping over-mounted mount points.help + man
-a, --asciiUse ascii characters for tree formatting.help + man
-b, --bytesprint sizes in bytes rather than in human readable formathelp + man
-C, --nocanonicalizedon't canonicalize when comparing pathshelp + man
-c, --canonicalizeCanonicalize all printed paths.help + man
-D, --dfImitate the output of df(1).help + man
-e, --evaluateConvert all tags (LABEL, UUID, PARTUUID, or PARTLABEL) to the corresponding device names for the SOURCE column.help + man
--hyperlink whenprint paths as hyperlinks (always|never|auto)help + man
-I, --dfiImitate the output of df(1) with its -i option.help + man
-J, --jsonUse JSON output format.help + man
-l, --listUse the list output format.help + man
-n, --noheadingsdon't print column headingshelp + man
-O, --options listlimit the set of filesystems by mount optionshelp + man
-o, --output listoutput columns (see --list-columns)help + man
--output-allOutput almost all available columns.help + man
-P, --pairsProduce output in the form of key="value" pairs.help + man
-r, --rawUse raw output format.help + man
--treeenable tree format output if possiblehelp + man
-u, --notruncateDo not truncate text in columns.help + man
-v, --nofsrootDo not print a [/dir] in the SOURCE column for bind mounts or btrfs subvolumes.help + man
-w, --timeout numSpecify an upper limit on the time for which --poll will block, in milliseconds.help + man
-y, --shellThe column name will be modified to contain only characters allowed for shell variable identifiers.help + man
-x, --verifyverify mount table content (default is fstab)help + man
--verboseForce findmnt to print more information (--verify only for now).help + man
--vfs-allWhen used with VFS-OPTIONS column, print all VFS (fs-independent) flags.help + man
-H, --list-columnsList the columns that can be specified with the --output option.help + man
-h, --helpDisplay help text and exit.help + man
-V, --versionDisplay version and exit.help + man
-d, --direction wordThe search direction, either forward or backward. (in the manual page but not in --help)man
-M, --mountpoint pathExplicitly define the mountpoint file or directory. (in the manual page but not in --help)man
Exit status (2) from the manual page
0there is something to display
1any error (for example if no filesystem is found based on the user’s filter specification

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.