chiark / gitweb /
01b4c446c6409e48df4e43e7bdc0d5907327333d
[elogind.git] / extras / volume_id / README
1 vol_id - probe filesystem and read label and uuid
2
3 This program is normally called from a udev rule, to provide udev with the
4 filesystem type of a volume and the label and uuid to name a device node.
5 vol_id opens the blockdevice node specified at the commandline. The following
6 commandline switches are supported to specify what vol_id should print:
7   --export        export key/value pairs
8   --type          filesystem type
9   --label         filesystem label
10   --label-raw     raw label
11   --uuid          filesystem uuid
12   --skip-raid     don't probe for raid
13   --probe-all     find possibly conflicting signatures
14   --help
15
16 vol_id will only return successful if the string asked for, is not
17 empty. All trailing whitespace will be removed, spaces replaced by underscore
18 and slashes ignored.
19
20 fstype                 probe  label  uuid  version
21 --------------------------------------------------
22 linux swap             *      *      *     *
23 ext                    *      *      *     *
24 reiserfs jr/3.5/3.6/4  *      *      *     *
25 fat (12, 16, 32)       *      *      *     *
26 ntfs                   *      *      *     *
27 jfs                    *      *      *     -
28 xfs                    *      *      *     -
29 hfs (plus, wrapped)    *      *      *     -
30 udf                    *      *      -     -
31 iso9660                *      *      -     -
32 ufs                    *      -      -     -
33 cramfs                 *      *      -     -
34 sysv                   *      *      -     *
35 luks                   *      -      *     -
36 hpfs                   *      -      -     -
37 romfs                  *      *      -     -
38 squashfs               *      -      -     -
39 minix                  *      -      -     *
40 ocfs (1, 2)            *      *      *     *
41 vxfs                   *      -      -     *
42 nss (netware)          *             *     *
43 gfs, gfs2              *      *      -     -
44
45 Raid members are detected to prevent the probing for a filesystem
46 -----------------------------------------------------------------
47 linux raid (md)        *      *      *     *
48 LVM 1                  *      -      -     -
49 LVM 2                  *      -      -     *
50 ddf                    *      -      *     *
51 highpoint              *      -      -     -
52 isw_raid               *      -      -     -
53 lsi_raid               *      -      -     -
54 nvidia_raid            *      -      -     -
55 promise_raid           *      -      -     -
56 silicon_raid           *      -      -     -
57 via_raid               *      -      -     -
58 jmicron                *      -      -     -
59 adaptec                *      -      -     -
60
61 To give it a try, you may call it on the commandline:
62   $ extras/volume_id/vol_id --export /dev/sda6
63   ID_FS_USAGE=filesystem
64   ID_FS_TYPE=ext3
65   ID_FS_VERSION=1.0
66   ID_FS_UUID=3e999973-00c9-4917-9442-b7633bd95b9e
67   ID_FS_LABEL=devel
68   ID_FS_LABEL_SAFE=devel
69
70   $ extras/volume_id/vol_id --label /dev/sda6
71   devel
72
73   $ extras/volume_id/vol_id --type /dev/sda6
74   ext3
75
76
77 Any comment/questions/concerns to me:
78   Kay Sievers <kay.sievers@vrfy.org>