X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=docs%2Fudev.xml;h=e0542a6be199048f024550dd784835bb17a47a6a;hb=1ef985452b0247ec32799b64ecabb85cb8ffe473;hp=e87dbab88078cea4509a0e0796aa0c16e3c3ade1;hpb=309d6fd302921489a93dca07f1675c9fc1f74a5a;p=elogind.git
diff --git a/docs/udev.xml b/docs/udev.xml
index e87dbab88..e0542a6be 100644
--- a/docs/udev.xml
+++ b/docs/udev.xml
@@ -27,7 +27,7 @@
udev
- 8
+ 7
@@ -148,66 +148,68 @@
- Match the kernel action name.
+ Match the name of the event action.
- Match the kernel device name
+ Match the name of the device.
- Match the kernel devpath.
+ Match the devpath of the device.
- Match the kernel subsystem name
+ Match the subsystem of the device.
- Match the type of bus the device is connected to.
+ Search the devpath upwards for a matching device subsystem name.
- Match the kernel driver name.
+ Search the devpath upwards for a matching device driver name.
- Match the device number on the bus.
+ Search the devpath upwards for a matching device name.
-
+
- Match against the value of an environment key. Depending on
- the specified operation, this key is also used as an assignment.
+ Search the devpath upwards for a device with matching sysfs attribute values.
+ Up to five keys can be specified per rule. All attributes
+ must match on the same device. Trailing whitespace in the attribute values is ignored,
+ if the specified match value does not contain trailing whitespace itself.
-
+
- Match the sysfs attribute value. Up to five values can be specified.
- Trailing whitespace is ignored, if the specified match value does not contain
- trailing whitespace itself.
+ Match against the value of an environment variable. Up to five
+ keys can be specified per rule. This key can also be used to export a variable to
+ the environment.
@@ -290,8 +292,8 @@
- Export the key to the environment. Depending on the specified
- operation, this key is also used as a match.
+ Export a variable to the environment. This key can also be used to match
+ against an environment variable.
@@ -320,7 +322,7 @@
- Import the printed result or the content of a file in environment key
+ Import the printed result or the value of a file in environment key
format into the event environment. will execute an
external program and read its output. will inport a
text file. If no option is given, udev will determine it from the executable
@@ -331,8 +333,8 @@
- Wait for the specified sysfs file of the device to be created. May be used
- to fight agains timing issues wth the kernel.
+ Wait for the specified sysfs file of the device to be created. Can be used
+ to fight against kernel sysfs timing issues.
@@ -351,68 +353,74 @@
The , , ,
- and fields support simple
- printf-like string substitutions:
+ , and
+ fields support simple printf-like string substitutions. The
+ format chars gets applied after all rules have been processed, right before the program
+ is executed. It allows the use of the complete environment set by earlier matching
+ rules. For all other fields, substitutions are applied while the individual rule is
+ being processed. The available substitutions are:
- ,
+ , The kernel name for this device.
- ,
+ ,
- The kernel bus id for this device.
+ The kernel number for this device. For example, 'sda3' has
+ kernel number of '3'
- ,
+ ,
- The kernel number for this device. For example, 'sda3' has
- kernel number of '3'
+ The devpath of the device.
- ,
+ ,
- The devpath of the device.
+ The name of the device matched while searching the devpath upwards for
+ , and .
+
- ,
+ ,
- The content of a sysfs attribute.
+ The value of a sysfs attribute found at the current or a parent device.
- ,
+ , The value of an environment variable.
- ,
+ , The kernel major number for the device.
-
+ The kernel minor number for the device.
- ,
+ , The string returned by the external program requested with PROGRAM.
A single part of the string, separated by a space character may be selected
@@ -423,21 +431,21 @@
- ,
+ , The node name of the parent device.
- ,
+ , The udev_root value.
- ,
+ , The name of a created temporary device node to provide access to
the device from a external program before the real node is created.
@@ -506,14 +514,11 @@
SEE ALSO
- udev8
+ udevd8,
udevinfo8,
-
- udevd8
- ,
udevmonitor8