X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=udev%2Fudev.xml;h=abbfee7ad13deff359a7fbe157b3f84b708e6572;hp=dc277c891884c66669c4d90d66af5038667e5db0;hb=7df0ed83c113e4744786e7804d398d9d34b43281;hpb=9f38b806d273e19c4fcb71fdcbaa9c61839b2a51
diff --git a/udev/udev.xml b/udev/udev.xml
index dc277c891..abbfee7ad 100644
--- a/udev/udev.xml
+++ b/udev/udev.xml
@@ -233,6 +233,13 @@
+
+
+
+ Search the devpath upwards for a device with matching tag.
+
+
+
@@ -359,7 +366,8 @@
Set a device property value. Property names with a leading '.'
- are not stored in the database or exported to external tool or events.
+ are neither stored in the database nor exported to events or
+ external tools (run by, say, the PROGRAM match key).
@@ -385,23 +393,25 @@
this or a dependent device. Long running tasks need to be immediately
detached from the event process itself.
If no absolute path is given, the program is expected to live in
- /lib/udev, otherwise the absolute path must be
- specified. Program name and arguments are separated by spaces. Single quotes
- can be used to specify arguments with spaces.
+ the directory provided at compile-time to configure via --libexecdir
+ (this is usually /lib/udev), otherwise the absolute
+ path must be specified. The program name and following arguments are
+ separated by spaces. Single quotes can be used to specify arguments with
+ spaces.
- Named label where a GOTO can jump to.
+ A named label to which a GOTO may jump.
- Jumps to the next LABEL with a matching name
+ Jumps to the next LABEL with a matching name.
@@ -423,8 +433,8 @@
- Import a text file specified as the assigned value, which must be in
- environment key format.
+ Import a text file specified as the assigned value, the content
+ of which must be in environment key format.
@@ -438,7 +448,7 @@
- Import a single property from the kernel commandline. For simple flags
+ Import a single property from the kernel command line. For simple flags
the value of the property is set to '1'.
@@ -462,9 +472,9 @@
- Wait for a file to become available or until a 10
- seconds timeout expires. The path is relative to the sysfs device,
- i. e. if no path is specified this waits for an attribute to appear.
+ Wait for a file to become available or until a timeout of
+ 10 seconds expires. The path is relative to the sysfs device;
+ if no path is specified, this waits for an attribute to appear.
@@ -498,7 +508,7 @@
- Apply the permissions specified in this rule to a static device node with
+ Apply the permissions specified in this rule to the static device node with
the specified name. Static device nodes might be provided by kernel modules
or copied from /lib/udev/devices. These nodes might not have
a corresponding kernel device at the time udevd is started; they can trigger
@@ -508,8 +518,8 @@
- Watch the device node with inotify; when closed after being opened for
- writing, a change uevent is synthesised.
+ Watch the device node with inotify; when the node is closed after being opened for
+ writing, a change uevent is synthesized.
@@ -525,10 +535,10 @@
The , , ,
, , 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 device properties set by earlier matching
- rules. For all other fields, substitutions are applied while the individual rule is
+ fields support simple string substitutions. The
+ substitutions are performed after all rules have been processed, right before the program
+ is executed, allowing for the use of device properties set by earlier matching
+ rules. For all other fields, substitutions are performed while the individual rule is
being processed. The available substitutions are:
@@ -577,9 +587,9 @@
The value of a sysfs attribute found at the device where
all keys of the rule have matched. If the matching device does not have
such an attribute, and a previous KERNELS, SUBSYSTEMS, DRIVERS, or
- ATTRS test selected a parent device, use the attribute from that
- parent device.
- If the attribute is a symlink, the last element of the symlink target is
+ ATTRS test selected a parent device, then the attribute from that
+ parent device is used.
+ If the attribute is a symlink, the last element of the symlink target is
returned as the value.
@@ -609,9 +619,9 @@
, The string returned by the external program requested with PROGRAM.
- A single part of the string, separated by a space character may be selected
+ A single part of the string, separated by a space character, may be selected
by specifying the part number as an attribute: .
- If the number is followed by the '+' char this part plus all remaining parts
+ If the number is followed by the '+' character, this part plus all remaining parts
of the result string are substituted:
@@ -634,8 +644,8 @@
- The current list of symlinks, separated by a space character. The value is
- only set if an earlier rule assigned a value, or during a remove events.
+ A space-separated list of the current symlinks. The value is
+ only set during a remove event or if an earlier rule assigned a value.
@@ -656,7 +666,7 @@
,
- The name of a created temporary device node to provide access to
+ The name of a temporary device node created to provide access to
the device from a external program before the real node is created.