misc-utils/findfs.8

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