diff options
| author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 02:42:50 +0000 |
|---|---|---|
| committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-05-06 02:42:50 +0000 |
| commit | 8cb83eee5a58b1fad74c34094ce3afb9e430b5a4 (patch) | |
| tree | a9b2e7baeca1be40eb734371e3c8b11b02294497 /misc-utils/findfs.8 | |
| parent | Initial commit. (diff) | |
| download | util-linux-upstream.tar.xz util-linux-upstream.zip | |
Adding upstream version 2.33.1.upstream/2.33.1upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'misc-utils/findfs.8')
| -rw-r--r-- | misc-utils/findfs.8 | 84 |
1 files changed, 84 insertions, 0 deletions
diff --git a/misc-utils/findfs.8 b/misc-utils/findfs.8 new file mode 100644 index 0000000..33bb242 --- /dev/null +++ b/misc-utils/findfs.8 @@ -0,0 +1,84 @@ +.\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. +.\" This file may be copied under the terms of the GNU Public License. +.\" +.TH FINDFS 8 "March 2014" "util-linux" "System Administration" +.SH NAME +findfs \- find a filesystem by label or UUID +.SH SYNOPSIS +.B findfs +.BI NAME= value +.SH DESCRIPTION +.B findfs +will search the block devices in the system looking for a filesystem or +partition with specified tag. The currently supported tags are: +.TP +.B LABEL=<label> +Specifies filesystem label. +.TP +.B UUID=<uuid> +Specifies filesystem UUID. +.TP +.B PARTUUID=<uuid> +Specifies partition UUID. This partition identifier is supported for example for +GUID Partition Table (GPT) partition tables. +.TP +.B PARTLABEL=<label> +Specifies partition label (name). The partition labels are supported for example for +GUID Partition Table (GPT) or MAC partition tables. +.PP +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 +.RS + +.br +.B lsblk \-\-fs +.br + +.B partx --show <disk> +.br + +.B blkid +.br + +.RE + +.PP +.SH "EXIT STATUS" +.RS +.PD 0 +.TP +.B 0 +success +.TP +.B 1 +label or uuid cannot be found +.TP +.B 2 +usage error, wrong number of arguments or unknown option +.PD +.RE +.SH AUTHOR +.B findfs +was originally written by +.MT tytso@mit.edu +Theodore Ts'o +.ME +and re-written for the util-linux package by +.MT kzak@redhat.com +Karel Zak +.ME . +.SH ENVIRONMENT +.IP LIBBLKID_DEBUG=all +enables libblkid debug output. +.SH SEE ALSO +.BR blkid (8), +.BR lsblk (8), +.BR partx (8) +.SH AVAILABILITY +The findfs command is part of the util-linux package and is available from +.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ +Linux Kernel Archive +.UE . |