findfs(8)

findfs8

Find a filesystem by label or uuid

Usage

findfs TAGNAME=value

Overview

findfs will search the block devices in the system for a filesystem or partition with the specified tag. The currently supported tags are:

LABEL=label

Specifies a filesystem label.

UUID=uuid

Specifies a filesystem UUID.

PARTUUID=uuid

Specifies a partition UUID. Partition identifiers are supported for example for GUID Partition Table (GPT) partition tables.

PARTLABEL=label

Specifies a partition label (name). Partition labels are supported for example for GPT and MAC partition tables.

If the filesystem or partition is found, the device name will be printed on stdout. If the input is not in the format of TAGNAME=value, then the input will be copied to the output without any modification.

You can get a complete overview about the filesystems and partitions in the system with one of the following commands:

lsblk --fs

partx --show disk

blkid

Options

-h, --help

Display help text and exit.

-V, --version

Display version and exit.

Exit status

0

success

1

label or UUID cannot be found

2

usage error, wrong number of arguments or unknown option

Environment

LIBBLKID_DEBUG=all

enables libblkid debug output.

Releases

12 releases since Debian 3.1 (Sarge); the text changed 11 times.

  1. 3.1
  2. 4.0
  3. 5.0
  4. 6.0
  5. 7
  6. 8
  7. 9
  8. 10
  9. 11
  10. 12
  11. 13
  12. Arch

--help since Debian 12 (Bookworm); --version since Debian 12 (Bookworm); -V since Debian 12 (Bookworm); -h since Debian 12 (Bookworm).

Authors

findfs was originally written by Theodore Ts’o <[email protected]> and re-written for the util-linux package by Karel Zak <[email protected]>.

Reporting bugs

For bug reports, use the issue tracker <https://github.com/util-linux/util-linux/issues>.

Availability

The findfs command is part of the util-linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util-linux/>.

From util-linux 2.42.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.