projects / thirdparty / util-linux.git / blame
| 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 . |