findfs(8) — Linux manual page

FINDFS(8)                 System Administration                 FINDFS(8)

NAME         top

       findfs - find a filesystem by label or UUID

SYNOPSIS         top

       findfs NAME=value

DESCRIPTION         top

       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. If the input is not in the format of
       NAME=value, then the input will be copied to the output without
       any modification.

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

          lsblk --fs

          partx --show <disk>

          blkid

       -h, --help
           Display help text and exit.

       -V, --version
           Display version and exit.

EXIT STATUS         top

       0
           success

       1
           label or uuid cannot be found

       2
           usage error, wrong number of arguments or unknown option

ENVIRONMENT         top

       LIBBLKID_DEBUG=all
           enables libblkid debug output.

AUTHORS         top

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

SEE ALSO         top

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

REPORTING BUGS         top

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

AVAILABILITY         top

       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/>. This page is
       part of the util-linux (a random collection of Linux utilities)
       project. Information about the project can be found at 
       ⟨https://www.kernel.org/pub/linux/utils/util-linux/⟩. If you have a
       bug report for this manual page, send it to
       util-linux@vger.kernel.org. This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2025-08-11. (At that time, the date of the most recent commit that
       was found in the repository was 2025-08-05.) If you discover any
       rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a
       mail to man-pages@man7.org

util-linux 2.42-start-521-ec46  2025-08-09                      FINDFS(8)

Pages that refer to this page: open_by_handle_at(2),  libblkid(3),  blkid(8),  wipefs(8)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.