man > findfs(8)

man perldoc info pydoc3 ri search

FINDFS(8) System Administration FINDFS(8)

🏷️ NAME

findfs - find a filesystem by label or UUID

🚀 Quick Reference

Use Case	Command	Description
🔍 Find device by filesystem label	findfs LABEL=label	Search for a filesystem with the given label
🔍 Find device by filesystem UUID	findfs UUID=uuid	Search for a filesystem with the given UUID
🔍 Find device by partition UUID	findfs PARTUUID=uuid	Search for a partition with the given UUID (e.g., GPT)
🔍 Find device by partition label	findfs PARTLABEL=label	Search for a partition with the given label (e.g., GPT or MAC)
📋 List all filesystems/partitions	lsblk --fs	Show filesystem information for all block devices
📋 Show partition table	partx --show	Display partition details for a disk
📋 Show block device attributes	blkid	List all block devices with labels/UUIDs

📖 SYNOPSIS

findfs NAME=value

📝 DESCRIPTION

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

• LABEL=<label> — 🏷️ Specifies filesystem label.
• UUID=<uuid> — 🔑 Specifies filesystem UUID.
• PARTUUID=<uuid> — 🧩 Specifies partition UUID. This partition identifier is supported for example for GUID Partition Table (GPT) partition tables.
• PARTLABEL=<label> — 🏷️ Specifies partition label (name). The partition labels are supported for example for GUID Partition Table (GPT) or MAC partition tables.

If the filesystem or partition is found, the device name will be printed on stdout.

The complete overview about filesystems and partitions you can get for example by:

lsblk --fs
partx --show <disk>
blkid

🚪 Exit Codes

• 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.

👤 AUTHORS

findfs was originally written by Theodore Ts’o <tytso AT mit.edu> and re-written for the util-linux package by Karel Zak <kzak AT redhat.com>.

📚 SEE ALSO

• blkid(8)
• lsblk(8)
• partx(8)

🐛 REPORTING BUGS

For bug reports, use the issue tracker at https://github.com/karelzak/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/>.

🏷️ NAME 🚀 Quick Reference 📖 SYNOPSIS 📝 DESCRIPTION 🚪 Exit Codes 🌍 ENVIRONMENT 👤 AUTHORS 📚 SEE ALSO 🐛 REPORTING BUGS 📦 AVAILABILITY