X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=extras%2Fvolume_id%2FREADME;h=0c5e37f9691c2fb00ec124b8e5b18a6e80e8cafc;hp=974a5016d9e1f5cdafd781cf3c08eb722d325337;hb=31c1f537450e96f8ddd6a0fad2adaefe57996f03;hpb=39e54555a961fa6c4c8e7d260a0e208439dc0cfa diff --git a/extras/volume_id/README b/extras/volume_id/README index 974a5016d..0c5e37f96 100644 --- a/extras/volume_id/README +++ b/extras/volume_id/README @@ -1,22 +1,25 @@ -vol_id - partition, filesystem, disklabel reader +vol_id - probe filesystem and read label and uuid 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. -vol_id opens the blockdevice node specified at the commandline. -The following commandline switches are supported to specify what vol_id -should print: - - --export prints all values - -h prints help text - -l prints the label of the partition - -u prints the uuid of the partition +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 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 fsversion ----------------------------------------------------- +fstype probe label uuid version +-------------------------------------------------- +linux swap * * * * ext * * * * reiserfs jr/3.5/3.6/4 * * * * fat (12, 16, 32) * * * * @@ -25,48 +28,52 @@ jfs * * * - xfs * * * - hfs (plus, wrapped) * * * - udf * * - - -iso9660 * * n/a - +iso9660 * * - - ufs * - - - -linux swap * * * * -LVM 1 * - - - -LVM 2 * - - * -linux raid * - * * cramfs * * - - sysv * * - * luks * - * - hpfs * - - - -romfs * -minix * -highpoint * -isw_raid * -lsi_raid * -nvidia_raid * -promise_raid * -silicon_raid * -via_raid * -mac partitons * -msdos partitions * +romfs * * - - +squashfs * - - - +minix * - - * +ocfs (1, 2) * * * * +vxfs * - - * +nss (netware) * * * +gfs, gfs2 * * - - +oracleasm * * - - - -The following rule will create a symlink named with the label string: - KERNEL=="[hs]d*", PROGRAM=="/sbin/vol_id -l %N", SYMLINK+="%c" - -If no label is found vol_id exits with nonzero and the rule will be -ignored. +Raid members are detected to prevent the probing for a filesystem +----------------------------------------------------------------- +linux raid (md) * * * * +LVM 1 * - - - +LVM 2 * - - * +ddf * - * * +highpoint * - - - +isw_raid * - - - +lsi_raid * - - - +nvidia_raid * - - - +promise_raid * - - - +silicon_raid * - - - +via_raid * - - - +jmicron * - - - +adaptec * - - - To give it a try, you may call it on the commandline: - [root@pim udev.kay]# extras/volume_id/vol_id /dev/hda3 - T:ext3 - L:Music Store - N:Music_Store - U:d2da42b5-bbd9-44eb-a72c-cc4542fcb71e + $ 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 - [root@pim udev.kay]# extras/volume_id/vol_id -l /dev/hda3 - Music_Store + $ extras/volume_id/vol_id --label /dev/sda6 + devel - [root@pim udev.kay]# extras/volume_id/vol_id -t /dev/hda3 - swap + $ extras/volume_id/vol_id --type /dev/sda6 + ext3 Any comment/questions/concerns to me: -Kay Sievers + Kay Sievers