]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
6c64d12d | 2 | // Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. |
f4cb44bd | 3 | // This file may be copied under the terms of the GNU General Public License. |
6c64d12d MB |
4 | = findfs(8) |
5 | :doctype: manpage | |
6 | :man manual: System Administration | |
7 | :man source: util-linux {release-version} | |
8 | :page-layout: base | |
9 | :command: findfs | |
10 | ||
11 | == NAME | |
12 | ||
13 | findfs - find a filesystem by label or UUID | |
14 | ||
15 | == SYNOPSIS | |
16 | ||
17 | *findfs* *NAME*=_value_ | |
18 | ||
19 | == DESCRIPTION | |
20 | ||
21 | *findfs* will search the block devices in the system looking for a filesystem or partition with specified tag. The currently supported tags are: | |
22 | ||
2c646c80 MB |
23 | *LABEL*=_<label>_:: |
24 | Specifies filesystem label. | |
6c64d12d | 25 | |
2c646c80 MB |
26 | *UUID*=_<uuid>_:: |
27 | Specifies filesystem UUID. | |
6c64d12d | 28 | |
2c646c80 MB |
29 | *PARTUUID*=_<uuid>_:: |
30 | Specifies partition UUID. This partition identifier is supported for example for GUID Partition Table (GPT) partition tables. | |
6c64d12d | 31 | |
2c646c80 MB |
32 | *PARTLABEL*=_<label>_:: |
33 | Specifies partition label (name). The partition labels are supported for example for GUID Partition Table (GPT) or MAC partition tables. | |
6c64d12d | 34 | |
07aacb37 | 35 | 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. |
6c64d12d MB |
36 | |
37 | The complete overview about filesystems and partitions you can get for example by | |
38 | ||
39 | ____ | |
40 | *lsblk --fs* | |
41 | ||
42 | *partx --show <disk>* | |
43 | ||
44 | *blkid* | |
45 | ____ | |
46 | ||
2b2d3172 MB |
47 | include::man-common/help-version.adoc[] |
48 | ||
6c64d12d MB |
49 | == EXIT STATUS |
50 | ||
6c64d12d | 51 | *0*:: |
2c646c80 | 52 | success |
6c64d12d | 53 | *1*:: |
2c646c80 | 54 | label or uuid cannot be found |
6c64d12d | 55 | *2*:: |
2c646c80 | 56 | usage error, wrong number of arguments or unknown option |
6c64d12d MB |
57 | |
58 | == ENVIRONMENT | |
59 | ||
60 | LIBBLKID_DEBUG=all:: | |
2c646c80 | 61 | enables libblkid debug output. |
6c64d12d MB |
62 | |
63 | == AUTHORS | |
64 | ||
2c646c80 | 65 | *findfs* was originally written by mailto:tytso@mit.edu[Theodore Ts'o] and re-written for the util-linux package by mailto:kzak@redhat.com[Karel Zak]. |
6c64d12d MB |
66 | |
67 | == SEE ALSO | |
68 | ||
69 | *blkid*(8), | |
70 | *lsblk*(8), | |
71 | *partx*(8) | |
72 | ||
625e9c61 | 73 | include::man-common/bugreports.adoc[] |
6c64d12d | 74 | |
625e9c61 | 75 | include::man-common/footer.adoc[] |
6c64d12d MB |
76 | |
77 | ifdef::translation[] | |
625e9c61 | 78 | include::man-common/translation.adoc[] |
6c64d12d | 79 | endif::[] |