summaryrefslogtreecommitdiff
path: root/extras/volume_id/README
diff options
context:
space:
mode:
authorkay.sievers@vrfy.org <kay.sievers@vrfy.org>2004-05-12 00:52:52 -0700
committerGreg KH <gregkh@suse.de>2005-04-26 21:35:17 -0700
commitcde5a756ce10530136b8d387346c48260a69dbfb (patch)
tree332d0d499fdad63e5b9ed57e8364e0fe9dcc2a0f /extras/volume_id/README
parent7f639ff99e3857870e4e0f41843dff7ad48ad784 (diff)
[PATCH] udev_volume_id update
Here is a update to extras/volume_id/* o The device is now specified by the DEVPATH in the environment, it's no longer needed to pass the major/minor to the callout. o leading spaces and slashes are now removed from the returned string and spaces are replaced by underscore, to not to confuse udev. o Arnd Bergmann <arnd@arndb.de> provided the code to recognize s390 dasd disk labels. The -d switch tries to read the main block device instead of the partition.
Diffstat (limited to 'extras/volume_id/README')
-rw-r--r--extras/volume_id/README49
1 files changed, 49 insertions, 0 deletions
diff --git a/extras/volume_id/README b/extras/volume_id/README
new file mode 100644
index 0000000000..9d881a1a05
--- /dev/null
+++ b/extras/volume_id/README
@@ -0,0 +1,49 @@
+
+udev_volume_id - partition, filesystem, disklabel reader
+
+This program is normally called from a udev rule, to provide udev with the
+name, uuid or the filesystem type of a partition to name a device node.
+udev_volume_id opens the blockdevice specified by the environment variable
+DEVPATH and searches for a filesystem superblock to read the label. The
+following commandline switches are supported to specify what udev_volume_id
+should print to stdout:
+
+ no option prints all values
+ -h prints help text
+ -l prints the label of the partition
+ -u prints the uuid of the partition
+ -d read disk instead of partition
+
+If -d is specified udev_volume_id tries to read the label from the main
+block device where the partition belongs to. For now this is only useful
+for s390 dasd labels.
+
+udev_volume_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.
+
+The following rule will create a symlink named with the label string:
+ KERNEL="[hs]d*", PROGRAM="/sbin/udev_volume_id -l", SYMLINK="%c"
+
+If no label is found udev_volume_id exits with nonzero and the rule will be
+ignored.
+
+To give it a try, you may call it on the commandline:
+
+ [root@pim udev.kay]# DEVPATH=/block/hda/hda3 extras/volume_id/udev_volume_id
+ T:ext3
+ L:Music Store
+ N:Music_Store
+ U:d2da42b5-bbd9-44eb-a72c-cc4542fcb71e
+
+ [root@pim udev.kay]# DEVPATH=/block/hda/hda3 extras/volume_id/udev_volume_id -l
+ Music_Store
+
+ [root@pim udev.kay]# DEVPATH=/block/hda/hda1 extras/volume_id/udev_volume_id -t
+ swap
+
+
+Please send any comment/questions/concerns to me or:
+ linux-hotplug-devel@lists.sourceforge.net
+
+Kay Sievers <kay.sievers@vrfy.org>