util-linux/misc-utils/findfs.8
Bjarni Ingi Gislason 8292383df7 doc: misc-utils/*: Fix some warnings from "mandoc -T lint"
mandoc: ./misc-utils/cal.1:214:2: WARNING: skipping paragraph macro: br after sp
mandoc: ./misc-utils/cal.1:216:2: WARNING: skipping paragraph macro: br before sp
mandoc: ./misc-utils/cal.1:225:2: WARNING: skipping paragraph macro: PP after SH

mandoc: ./misc-utils/findfs.8:36:2: WARNING: skipping paragraph macro: br after sp
mandoc: ./misc-utils/findfs.8:38:2: WARNING: skipping paragraph macro: br before sp
mandoc: ./misc-utils/findfs.8:41:2: WARNING: skipping paragraph macro: br before sp
mandoc: ./misc-utils/findfs.8:44:2: WARNING: skipping paragraph macro: br before sp
mandoc: ./misc-utils/findfs.8:48:2: WARNING: skipping paragraph macro: PP empty

mandoc: ./misc-utils/logger.1:118:15: STYLE: unterminated quoted argument
mandoc: ./misc-utils/logger.1:231:2: WARNING: skipping paragraph macro: IP empty

mandoc: ./misc-utils/look.1:116:2: STYLE: fill mode already disabled, skipping: nf

mandoc: ./misc-utils/hardlink.1:1:5: STYLE: lower case character in document title: TH hardlink
mandoc: ./misc-utils/hardlink.1:1:2: WARNING: missing date, using today's date: TH
mandoc: ./misc-utils/hardlink.1:9:2: WARNING: skipping paragraph macro: PP after SH
mandoc: ./misc-utils/hardlink.1:52:2: WARNING: skipping paragraph macro: PP after SH
mandoc: ./misc-utils/hardlink.1:65:2: WARNING: skipping paragraph macro: PP after SH

mandoc: ./misc-utils/rename.1:65:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./misc-utils/rename.1:65:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./misc-utils/rename.1:97:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./misc-utils/rename.1:107:2: WARNING: skipping paragraph macro: PP empty
mandoc: ./misc-utils/rename.1:116:2: WARNING: skipping paragraph macro: PP empty

mandoc: ./misc-utils/whereis.1:82:2: WARNING: line scope broken: IP breaks TP
mandoc: ./misc-utils/whereis.1:152:2: WARNING: skipping paragraph macro: PP empty

####

  There is no change in the ouput of "nroff" or "groff", except for

1) a very long line in "logger.1".

2) '-' changed to '\-' for a option in "logger.1".

Signed-off-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
2020-06-15 11:28:01 +02:00

79 lines
1.7 KiB
Groff

.\" 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
.B lsblk \-\-fs
.B partx --show <disk>
.B blkid
.RE
.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 ENVIRONMENT
.IP LIBBLKID_DEBUG=all
enables libblkid debug output.
.SH AUTHORS
.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 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 .