chiark / gitweb /
path_id: remove broken example
authorKay Sievers <kay.sievers@vrfy.org>
Sun, 22 Apr 2007 12:19:14 +0000 (14:19 +0200)
committerKay Sievers <kay.sievers@vrfy.org>
Sun, 22 Apr 2007 12:19:14 +0000 (14:19 +0200)
extras/path_id/path_id
extras/path_id/path_id.8

index 8927d84ffb729215be1c3a56836b941518d6324c..a7d650bf423b62b46cfd188d3b31c9814d370c53 100644 (file)
 #      This program is free software; you can redistribute it and/or modify it
 #      under the terms of the GNU General Public License as published by the
 #      Free Software Foundation version 2 of the License.
-#
-# to be called from a udev rule to return the name for a symlink
-#      DEVPATH=<devpath>; path_id
-#      path_id <devpath>
-
-# examples for all block devices on a system:
-#      for i in `find /sys/class/block`; do DEVPATH="`echo $i | sed -e 's@^/sys\|/dev@@g'`"; path_id; done
 
 SYSFS=/sys
 RESULT=1
index e55914de31a48056f6cacc3c0aecde20af27341a..9dc59659799fe060d983b2555edf3d43ce92b315 100644 (file)
@@ -1,25 +1,14 @@
 .TH PATH_ID 8 "April 2007" "" "Linux Administrator's Manual"
 .SH NAME
-path_id \- udev callout to provide the shortest possible unique hardware path
-to a device for the Linux Persistent Device Naming scheme
+path_id \- udev callout to create a device path based unique name
+for a device to implement the Linux Persistent Device Naming scheme
 .SH SYNOPSIS
-DEVPATH=<devpath>; path_id
-
 path_id <devpath>
 .SH "DESCRIPTION"
 .B path_id
-is normally called from a udev rule, to provide udev a unique hardware path for
-a device. Udev can use this information to create symlinks in /dev/ to the real
-device node.
-.SH EXAMPLES
-For all block devices on a system:
-
-.nf
-for i in `find /sys/class/block`
-do
-       DEVPATH="`echo $i | sed -e 's@^/sys\|/dev@@g'`"; path_id
-done
-.fi
+is normally called from a udev rule, to create a unique name, based on
+the device properties along the chain of parent devices. Udev uses this
+information to create a persistent symlink to the real device node.
 .SH SEE ALSO
 .BR udev (7)
 .SH AUTHORS