# man > findmnt(8)

---
type: CommandReference
command: findmnt
mode: man
section: 8
source: man-pages
---

## Quick Reference

- `findmnt` — list all mounted filesystems (tree format)
- `findmnt /mnt/foo` — display filesystem for mountpoint
- `findmnt -t ext4` — filter by filesystem type
- `findmnt -o TARGET,SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%` — custom columns
- `findmnt -D` — imitate df output
- `findmnt --fstab -t nfs` — show NFS entries from /etc/fstab
- `findmnt -J` — JSON output
- `findmnt --poll --mountpoint /mnt/foo` — monitor mount changes

## Name

findmnt - find a filesystem

## Synopsis

`findmnt` [options]

`findmnt` [options] _device_|_mountpoint_

`findmnt` [options] [--source] _device_ [--target _path_|--mountpoint _mountpoint_]

## Options

### General Output Control

- `-A, --all` — disable all built-in filters, print all filesystems
- `-l, --list` — use list output format (not tree)
- `--tree` — enable tree-like output if possible
- `-J, --json` — JSON output format
- `-P, --pairs` — key="value" pairs output
- `-r, --raw` — raw output (hex-escapes unsafe chars)
- `-n, --noheadings` — omit header line
- `-b, --bytes` — print SIZE, USED, AVAIL in bytes (not human-readable)
- `-u, --notruncate` — do not truncate text in columns
- `-a, --ascii` — use ASCII characters for tree formatting
- `-c, --canonicalize` — canonicalize all printed paths
- `-C, --nocanonicalize` — do not canonicalize paths
- `-v, --nofsroot` — do not print [/dir] for bind mounts/btrfs subvolumes
- `-D, --df` — imitate df output (equivalent to `-o SOURCE,FSTYPE,SIZE,USED,AVAIL,USE%,TARGET`, excludes pseudo filesystems)
- `-e, --evaluate` — convert tags (LABEL, UUID, etc.) to device names
- `-i, --invert` — invert match sense
- `-f, --first-only` — print first matching filesystem only
- `-U, --uniq` — skip duplicate mount targets (over-mounted points)
- `--pseudo` — only pseudo filesystems
- `--real` — only real filesystems
- `--shadow` / `--shadowed` — only filesystems over-mounted by another
- `--vfs-all` — with VFS-OPTIONS column, print all VFS flags (including defaults)

### Search and Filtering

- `-t, --types <list>` — limit by filesystem type (comma-separated, prefix with `no` to exclude)
- `-O, --options <list>` — limit by mount options (comma-separated, prefix `no` to negate, `+` to disable prefix)
- `-S, --source <spec>` — explicit mount source: device, maj:min, LABEL=, UUID=, PARTLABEL=, PARTUUID=
- `-T, --target <path>` — define mount target (checks path elements in reverse order if not a mountpoint)
- `-M, --mountpoint <path>` — explicitly define mountpoint (no reverse check)
- `-R, --submounts` — recursively print all submounts for selected filesystems
- `-d, --direction <forward|backward>` — search direction
- `-F, --tab-file <path>` — search in alternative file (overrides default paths for fstab/mtab/kernel)
- `-k, --kernel` — search in /proc/self/mountinfo (default, tree format)
- `-m, --mtab` — search in /etc/mtab (list format)
- `-s, --fstab` — search in /etc/fstab (list format)
- `-N, --task <tid>` — use alternative namespace (e.g., /proc/123/mountinfo)
- `-x, --verify` — check mount table content (default /etc/fstab), filterable by device/mountpoint
- `--verbose` — more details (only with --verify for now)

### Output Columns

- `-o, --output <list>` — define output columns (see `--help` for list). Use `+list` to extend default.
- `--output-all` — output almost all columns (except poll-specific)

### Polling

- `-p, --poll[=<actions>]` — monitor changes in /proc/self/mountinfo. Actions: mount, umount, remount, move (comma-separated, defaults to all). Extra columns: ACTION, OLD-TARGET, OLD-OPTIONS.
- `-w, --timeout <ms>` — max block time for --poll
- `-f, --first-only` (poll) — exit after first event

### Miscellaneous

- `-h, --help` — display help and exit

## Environment

- `LIBMOUNT_FSTAB=<path>` — override fstab location
- `LIBMOUNT_MTAB=<path>` — override mtab location
- `LIBMOUNT_DEBUG=all` — enable libmount debug
- `LIBSMARTCOLS_DEBUG=all` — enable libsmartcols debug
- `LIBSMARTCOLS_DEBUG_PADDING=on` — use visible padding characters

## Examples

- `findmnt --fstab -t nfs` — print all NFS filesystems defined in /etc/fstab
- `findmnt --fstab /mnt/foo` — print /etc/fstab entries where mountpoint is /mnt/foo (includes bind mounts sourced from /mnt/foo)
- `findmnt --fstab --target /mnt/foo` — print /etc/fstab entries where mountpoint is /mnt/foo
- `findmnt --fstab --evaluate` — print /etc/fstab entries, converting LABEL= and UUID= to real device names
- `findmnt -n --raw --evaluate --output=target LABEL=/boot` — print mountpoint of filesystem with label "/boot"
- `findmnt --poll --mountpoint /mnt/foo` — monitor mount, unmount, remount, move on /mnt/foo
- `findmnt --poll=umount --first-only --mountpoint /mnt/foo` — wait for /mnt/foo unmount
- `findmnt --poll=remount -t ext3 -O ro` — monitor remounts to read-only on all ext3 filesystems

## See Also

- [fstab(5)](https://www.chedong.com/phpMan.php/man/fstab/5/markdown)
- [mount(8)](https://www.chedong.com/phpMan.php/man/mount/8/markdown)