]>
Commit | Line | Data |
---|---|---|
940817b7 KZ |
1 | .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. |
2 | .\" This file may be copied under the terms of the GNU Public License. | |
3 | .\" | |
753d9bb2 | 4 | .TH FINDFS 8 "March 2014" "util-linux" "System Administration" |
940817b7 | 5 | .SH NAME |
0791a058 | 6 | findfs \- find a filesystem by label or UUID |
940817b7 KZ |
7 | .SH SYNOPSIS |
8 | .B findfs | |
c48508c2 | 9 | .BI NAME= value |
940817b7 KZ |
10 | .SH DESCRIPTION |
11 | .B findfs | |
c48508c2 KZ |
12 | will search the block devices in the system looking for a filesystem or |
13 | partition with specified tag. The currently supported tags are: | |
14 | .TP | |
15 | .B LABEL=<label> | |
16 | Specifies filesystem label. | |
17 | .TP | |
18 | .B UUID=<uuid> | |
19 | Specifies filesystem UUID. | |
20 | .TP | |
21 | .B PARTUUID=<uuid> | |
22 | Specifies partition UUID. This partition identifier is supported for example for | |
23 | GUID Partition Table (GPT) partition tables. | |
24 | .TP | |
25 | .B PARTLABEL=<label> | |
26 | Specifies partition label (name). The partition labels are supported for example for | |
27 | GUID Partition Table (GPT) or MAC partition tables. | |
28 | .PP | |
29 | If the filesystem or partition is found, the device name will be printed on | |
30 | stdout. | |
31 | ||
32 | The complete overview about filesystems and partitions you can get for example | |
33 | by | |
34 | .RS | |
35 | ||
36 | .br | |
0bb7e904 | 37 | .B lsblk \-\-fs |
c48508c2 KZ |
38 | .br |
39 | ||
0bb7e904 | 40 | .B partx --show <disk> |
c48508c2 KZ |
41 | .br |
42 | ||
0bb7e904 | 43 | .B blkid |
c48508c2 KZ |
44 | .br |
45 | ||
46 | .RE | |
47 | ||
940817b7 | 48 | .PP |
753d9bb2 SK |
49 | .SH "EXIT STATUS" |
50 | .RS | |
51 | .PD 0 | |
52 | .TP | |
53 | .B 0 | |
54 | success | |
55 | .TP | |
56 | .B 1 | |
57 | label or uuid cannot be found | |
58 | .TP | |
59 | .B 2 | |
60 | usage error, wrong number of arguments or unknown option | |
61 | .PD | |
62 | .RE | |
940817b7 KZ |
63 | .SH AUTHOR |
64 | .B findfs | |
753d9bb2 SK |
65 | was originally written by |
66 | .MT tytso@mit.edu | |
67 | Theodore Ts'o | |
68 | .ME | |
69 | and re-written for the util-linux package by | |
70 | .MT kzak@redhat.com | |
71 | Karel Zak | |
72 | .ME . | |
ddfeda98 | 73 | .SH ENVIRONMENT |
68e422ec KZ |
74 | .IP LIBBLKID_DEBUG=all |
75 | enables libblkid debug output. | |
940817b7 | 76 | .SH SEE ALSO |
66083665 | 77 | .BR blkid (8), |
c48508c2 KZ |
78 | .BR lsblk (8), |
79 | .BR partx (8) | |
9c91fc03 BS |
80 | .SH AVAILABILITY |
81 | The findfs command is part of the util-linux package and is available from | |
d673b74e | 82 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
753d9bb2 SK |
83 | Linux Kernel Archive |
84 | .UE . |