misc-utils/findfs.8

   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 .\"
   4 .TH FINDFS 8 "March 2014" "util-linux" "System Administration"
   5 .SH NAME
   6 findfs \- find a filesystem by label or UUID
   7 .SH SYNOPSIS
   8 .B findfs
   9 .BI NAME= value
  10 .SH DESCRIPTION
  11 .B findfs
  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
  37 .B lsblk \-\-fs
  38 .br
  39
  40 .B partx --show <disk>
  41 .br
  42
  43 .B blkid
  44 .br
  45
  46 .RE
  47
  48 .PP
  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
  63 .SH AUTHOR
  64 .B findfs
  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 .
  73 .SH ENVIRONMENT
  74 .IP LIBBLKID_DEBUG=all
  75 enables libblkid debug output.
  76 .SH SEE ALSO
  77 .BR blkid (8),
  78 .BR lsblk (8),
  79 .BR partx (8)
  80 .SH AVAILABILITY
  81 The findfs command is part of the util-linux package and is available from
  82 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
  83 Linux Kernel Archive
  84 .UE .