chiark / gitweb /
remove no longer needed includes
[elogind.git] / extras / volume_id / README
1 vol_id - partition, filesystem, disklabel reader
2
3 This program is normally called from a udev rule, to provide udev with the
4 name, uuid or the filesystem type of a partition to name a device node.
5 vol_id opens the blockdevice node specified at the commandline.
6 The following commandline switches are supported to specify what vol_id
7 should print:
8
9   --export prints all values
10   -h       prints help text
11   -l       prints the label of the partition
12   -u       prints the uuid of the partition
13
14 vol_id will only return successful if the string asked for, is not
15 empty. All trailing whitespace will be removed, spaces replaced by underscore
16 and slashes ignored.
17
18 fstype                 probe  label  uuid  fsversion
19 ----------------------------------------------------
20 ext                    *      *      *     *
21 reiserfs jr/3.5/3.6/4  *      *      *     *
22 fat (12, 16, 32)       *      *      *     *
23 ntfs                   *      *      *     *
24 jfs                    *      *      *     -
25 xfs                    *      *      *     -
26 hfs (plus, wrapped)    *      *      *     -
27 udf                    *      *      -     -
28 iso9660                *      *      n/a   -
29 ufs                    *      -      -     -
30 linux swap             *      *      *     *
31 LVM 1                  *      -      -     -
32 LVM 2                  *      -      -     *
33 linux raid             *      -      *     *
34 cramfs                 *      *      -     -
35 sysv                   *      *      -     *
36 luks                   *      -      *     -
37 hpfs                   *      -      -     -
38 romfs                  *
39 minix                  *
40 highpoint              *
41 isw_raid               *
42 lsi_raid               *
43 nvidia_raid            *
44 promise_raid           *
45 silicon_raid           *
46 via_raid               *
47 mac partitons          *
48 msdos partitions       *
49
50
51 The following rule will create a symlink named with the label string:
52   KERNEL=="[hs]d*", PROGRAM=="/sbin/vol_id -l %N", SYMLINK+="%c"
53
54 If no label is found vol_id exits with nonzero and the rule will be
55 ignored.
56
57 To give it a try, you may call it on the commandline:
58   [root@pim udev.kay]# extras/volume_id/vol_id /dev/hda3
59   T:ext3
60   L:Music Store
61   N:Music_Store
62   U:d2da42b5-bbd9-44eb-a72c-cc4542fcb71e
63
64   [root@pim udev.kay]# extras/volume_id/vol_id -l /dev/hda3
65   Music_Store
66
67   [root@pim udev.kay]# extras/volume_id/vol_id -t /dev/hda3
68   swap
69
70
71 Any comment/questions/concerns to me:
72 Kay Sievers <kay.sievers@vrfy.org>