chiark / gitweb /
bb248a45e087ca6691734bbcbfc9e0fd58bc664c
[elogind.git] / extras / volume_id / vol_id.8
1 .\"     Title: vol_id
2 .\"    Author: 
3 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
4 .\"      Date: March 2006
5 .\"    Manual: vol_id
6 .\"    Source: volume_id
7 .\"
8 .TH "VOL_ID" "8" "March 2006" "volume_id" "vol_id"
9 .\" disable hyphenation
10 .nh
11 .\" disable justification (adjust text to left margin only)
12 .ad l
13 .SH "NAME"
14 vol_id \- probe filesystem type and read label and uuid
15 .SH "SYNOPSIS"
16 .HP 7
17 \fBvol_id\fR [\fB\-\-export\fR] [\fB\-t\fR] [\fB\-l\fR] [\fB\-u\fR] [\fIdevice\fR]
18 .SH "DESCRIPTION"
19 .PP
20 \fBvol_id\fR
21 is usually called from a udev rule, to provide udev with the filesystem type, the label and the uuid of a volume.
22 \fBvol_id\fR
23 supports all common filesystem formats and detects various raid setups to prevent the recognition of raid members as a volume with a filesystem.
24 .SH "OPTIONS"
25 .PP
26 \fB\-\-export\fR
27 .RS 4
28 print all values in key/value format to import them into the environment.
29 .RE
30 .PP
31 \fB\-t\fR
32 .RS 4
33 print the filesystem type
34 .RE
35 .PP
36 \fB\-l\fR
37 .RS 4
38 print the safe version of volume label suitable for use as filename. Use
39 \fB\-L\fR
40 to print literal label
41 .RE
42 .PP
43 \fB\-u\fR
44 .RS 4
45 print the uuid of a volume
46 .RE
47 .PP
48 \fB\-L\fR
49 .RS 4
50 print raw volume label
51 .RE
52 .SH "ENVIRONMENT"
53 .PP
54 \fBUDEV_LOG\fR
55 .RS 4
56 Set the syslog priority.
57 .RE
58 .SH "EXIT STATUS"
59 .PP
60 \fBvol_id\fR
61 will only return successful if the value asked for is not empty. All trailing whitespace will be removed, spaces replaced by underscore and slashes ignored.
62 .SH "AUTHOR"
63 .PP
64 Written by Kay Sievers
65 <kay.sievers@vrfy.org>
66 .SH "SEE ALSO"
67 .PP
68 \fBudev\fR(7)