123 lines
No EOL
2.6 KiB
Groff
123 lines
No EOL
2.6 KiB
Groff
'\" t
|
|
.\" Title: findfs
|
|
.\" Author: [see the "AUTHOR(S)" section]
|
|
.\" Generator: Asciidoctor 2.0.20
|
|
.\" Date: 2025-02-26
|
|
.\" Manual: System Administration
|
|
.\" Source: util-linux 2.41
|
|
.\" Language: English
|
|
.\"
|
|
.TH "FINDFS" "8" "2025-02-26" "util\-linux 2.41" "System Administration"
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.ss \n[.ss] 0
|
|
.nh
|
|
.ad l
|
|
.de URL
|
|
\fI\\$2\fP <\\$1>\\$3
|
|
..
|
|
.als MTO URL
|
|
.if \n[.g] \{\
|
|
. mso www.tmac
|
|
. am URL
|
|
. ad l
|
|
. .
|
|
. am MTO
|
|
. ad l
|
|
. .
|
|
. LINKSTYLE blue R < >
|
|
.\}
|
|
.SH "NAME"
|
|
findfs \- find a filesystem by label or UUID
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
\fBfindfs\fP \fBNAME\fP=\fIvalue\fP
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
\fBfindfs\fP will search the block devices in the system looking for a filesystem or partition with specified tag. The currently supported tags are:
|
|
.sp
|
|
\fBLABEL\fP=\fI<label>\fP
|
|
.RS 4
|
|
Specifies filesystem label.
|
|
.RE
|
|
.sp
|
|
\fBUUID\fP=\fI<uuid>\fP
|
|
.RS 4
|
|
Specifies filesystem UUID.
|
|
.RE
|
|
.sp
|
|
\fBPARTUUID\fP=\fI<uuid>\fP
|
|
.RS 4
|
|
Specifies partition UUID. This partition identifier is supported for example for GUID Partition Table (GPT) partition tables.
|
|
.RE
|
|
.sp
|
|
\fBPARTLABEL\fP=\fI<label>\fP
|
|
.RS 4
|
|
Specifies partition label (name). The partition labels are supported for example for GUID Partition Table (GPT) or MAC partition tables.
|
|
.RE
|
|
.sp
|
|
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.
|
|
.sp
|
|
The complete overview about filesystems and partitions you can get for example by
|
|
.RS 3
|
|
.ll -.6i
|
|
.sp
|
|
\fBlsblk \-\-fs\fP
|
|
.sp
|
|
\fBpartx \-\-show <disk>\fP
|
|
.sp
|
|
\fBblkid\fP
|
|
.br
|
|
.RE
|
|
.ll
|
|
.sp
|
|
\fB\-h\fP, \fB\-\-help\fP
|
|
.RS 4
|
|
Display help text and exit.
|
|
.RE
|
|
.sp
|
|
\fB\-V\fP, \fB\-\-version\fP
|
|
.RS 4
|
|
Display version and exit.
|
|
.RE
|
|
.SH "EXIT STATUS"
|
|
.sp
|
|
\fB0\fP
|
|
.RS 4
|
|
success
|
|
.RE
|
|
.sp
|
|
\fB1\fP
|
|
.RS 4
|
|
label or uuid cannot be found
|
|
.RE
|
|
.sp
|
|
\fB2\fP
|
|
.RS 4
|
|
usage error, wrong number of arguments or unknown option
|
|
.RE
|
|
.SH "ENVIRONMENT"
|
|
.sp
|
|
LIBBLKID_DEBUG=all
|
|
.RS 4
|
|
enables libblkid debug output.
|
|
.RE
|
|
.SH "AUTHORS"
|
|
.sp
|
|
\fBfindfs\fP was originally written by \c
|
|
.MTO "tytso\(atmit.edu" "Theodore Ts\(cqo" ""
|
|
and re\-written for the util\-linux package by
|
|
.MTO "kzak\(atredhat.com" "Karel Zak" "."
|
|
.SH "SEE ALSO"
|
|
.sp
|
|
\fBblkid\fP(8),
|
|
\fBlsblk\fP(8),
|
|
\fBpartx\fP(8)
|
|
.SH "REPORTING BUGS"
|
|
.sp
|
|
For bug reports, use the \c
|
|
.URL "https://github.com/util\-linux/util\-linux/issues" "issue tracker" "."
|
|
.SH "AVAILABILITY"
|
|
.sp
|
|
The \fBfindfs\fP command is part of the util\-linux package which can be downloaded from \c
|
|
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "." |