findfs(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | EXIT STATUS | ENVIRONMENT | AUTHORS | SEE ALSO | REPORTING BUGS | AVAILABILITY

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
           Print 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 <[email protected]>
       and re-written for the util-linux package by Karel Zak
       <[email protected]>.

SEE ALSO         top

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

REPORTING BUGS         top

       For bug reports, use the issue tracker at
       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
       [email protected]. This page was obtained from the
       project's upstream Git repository
       ⟨git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git⟩ on
       2024-06-14. (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-10.) 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 [email protected]

util-linux 2.41.devel-537-e... 2024-06-13                      FINDFS(8)

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