findfs - Man Page

• Search block devices by filesystem label: findfs LABEL=label
• Search by filesystem UUID: findfs UUID=uuid
• Search by partition label (GPT or MAC partition table): findfs PARTLABEL=partition_label
• Search by partition UUID (GPT partition table only): findfs PARTUUID=partition_uuid

tldr.sh

findfs TAGNAME=value

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:

-h,  --help

Display help text and exit.

-V,  --version

Display version and exit.

0

success

1

label or UUID cannot be found

2

usage error, wrong number of arguments or unknown option

LIBBLKID_DEBUG=all

enables libblkid debug output.

findfs was originally written by Theodore Ts’o and re-written for the util-linux package by Karel Zak.

blkid(8), lsblk(8), partx(8)

For bug reports, use the issue tracker.

The findfs command is part of the util-linux package which can be downloaded from Linux Kernel Archive.

blkid(8), libblkid(3), open_by_handle_at(2), wipefs(8).