summaryrefslogtreecommitdiff
path: root/extras
diff options
context:
space:
mode:
authorKay Sievers <kay.sievers@vrfy.org>2008-10-13 03:34:37 +0200
committerKay Sievers <kay.sievers@vrfy.org>2008-10-13 03:34:37 +0200
commitf4700eb8a02c17972c3cef658bd8c96a725355b8 (patch)
treee6994dbd903501bfcd5922faa968cdd1b1b9ae1d /extras
parent2f664629829d8ed52a8bc55b31faf8ec8b65bd3c (diff)
vol_id: update README
Diffstat (limited to 'extras')
-rw-r--r--extras/volume_id/README59
1 files changed, 23 insertions, 36 deletions
diff --git a/extras/volume_id/README b/extras/volume_id/README
index 44a9a875f3..9459c880f8 100644
--- a/extras/volume_id/README
+++ b/extras/volume_id/README
@@ -1,25 +1,31 @@
vol_id - probe filesystem and read label and uuid
-This program is normally called from a udev rule, to provide udev with the
-filesystem type of a volume and the label and uuid to name a device node.
-vol_id opens the blockdevice node specified at the commandline. The following
-commandline switches are supported to specify what vol_id should print:
- --export export key/value pairs
- --type filesystem type
- --label filesystem label
- --label-raw raw label
- --uuid filesystem uuid
- --skip-raid don't probe for raid
- --probe-all find possibly conflicting signatures
- --help
+vol_id will only return with a non-zero exit code if the string asked for,
+is not empty. All trailing whitespace will be removed, spaces replaced by
+underscore and slashes ignored.
+Unmangled values are available in the --export mode as hex-encoded strings
+in *_ENC= keys.
+
+ $ extras/volume_id/vol_id --export /dev/sda6
+ ID_FS_USAGE=filesystem
+ ID_FS_TYPE=ext3
+ ID_FS_VERSION=1.0
+ ID_FS_UUID=3e999973-00c9-4917-9442-b7633bd95b9e
+ ID_FS_UUID_ENC=3e999973-00c9-4917-9442-b7633bd95b9e
+ ID_FS_LABEL=devel
+ ID_FS_LABEL_ENC=devel
+
+ $ extras/volume_id/vol_id --label /dev/sda6
+ devel
+
+ $ extras/volume_id/vol_id --type /dev/sda6
+ ext3
-vol_id will only return successful if the string asked for, is not
-empty. All trailing whitespace will be removed, spaces replaced by underscore
-and slashes ignored.
fstype probe label uuid version
--------------------------------------------------
linux swap * * * *
+btrfs * * * -
ext * * * *
reiserfs jr/3.5/3.6/4 * * * *
fat (12, 16, 32) * * * *
@@ -33,13 +39,13 @@ ufs * - - -
cramfs * * - -
sysv * * - *
luks * - * -
-hpfs * - - -
+hpfs * * - -
romfs * * - -
squashfs * - - -
minix * - - *
ocfs (1, 2) * * * *
vxfs * - - *
-nss (netware) * * *
+nss (netware) * - * *
gfs, gfs2 * * * -
oracleasm * * - -
@@ -58,22 +64,3 @@ silicon_raid * - - -
via_raid * - - -
jmicron * - - -
adaptec * - - -
-
-To give it a try, you may call it on the commandline:
- $ extras/volume_id/vol_id --export /dev/sda6
- ID_FS_USAGE=filesystem
- ID_FS_TYPE=ext3
- ID_FS_VERSION=1.0
- ID_FS_UUID=3e999973-00c9-4917-9442-b7633bd95b9e
- ID_FS_LABEL=devel
- ID_FS_LABEL_SAFE=devel
-
- $ extras/volume_id/vol_id --label /dev/sda6
- devel
-
- $ extras/volume_id/vol_id --type /dev/sda6
- ext3
-
-
-Any comment/questions/concerns to me:
- Kay Sievers <kay.sievers@vrfy.org>