X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fudev.xml;h=e253a0677a95c4a7a7e9b5aea9adbf305bfcf2d7;hb=5a33334b8ad49798510a2ce29e451194c6ecb618;hp=7ec7a3fed00cd1cef242bbc4c255987fa0e91986;hpb=bb31a4ac1997c189a344caf554f34c6aabc71aa7;p=elogind.git
diff --git a/man/udev.xml b/man/udev.xml
index 7ec7a3fed..e253a0677 100644
--- a/man/udev.xml
+++ b/man/udev.xml
@@ -54,28 +54,7 @@
sources is provided by the library libudev.
- Configuration
- udev configuration files are placed in /etc/udev
- and /usr/lib/udev. All empty lines or lines beginning with
- '#' are ignored.
-
- Configuration file
- udev expects its main configuration file at /etc/udev/udev.conf.
- It consists of a set of variables allowing the user to override default udev values.
- The following variables can be set:
-
-
-
-
- The logging priority. Valid values are the numerical syslog priorities
- or their textual representations: ,
- and .
-
-
-
-
-
- Rules files
+ Rules filesThe udev rules are read from the files located in the
system rules directory /usr/lib/udev/rules.d,
the volatile runtime directory /run/udev/rules.d
@@ -94,9 +73,10 @@
extensions are ignored.Every line in the rules file contains at least one key-value pair.
+ Except for empty lines or lines beginning with '#', which are ignored.
There are two kinds of keys: match and assignment.
- If all match keys are matching against its value, the rule gets applied and the
- assignment keys get the specified value assigned.
+ If all match keys match against their values, the rule gets applied and the
+ assignment keys get the specified values assigned.
A matching rule may rename a network interface, add symlinks
pointing to the device node, or run a specified program as part of
@@ -107,21 +87,21 @@
operators are:
-
+ ==Compare for equality.
-
+ !=Compare for inequality.
-
+ =Assign a value to a key. Keys that represent a list are reset
and only this single value is assigned.
@@ -129,14 +109,14 @@
-
+ +=Add the value to a key that holds a list of entries.
-
+ :=Assign a value to a key finally; disallow any later changes.
@@ -148,7 +128,7 @@
not only the device that has generated the event. If multiple keys that match
a parent device are specified in a single rule, all these keys must match at
one and the same parent device.
-
+
@@ -297,19 +277,19 @@
pattern characters are supported:
-
+ *Matches zero or more characters.
-
+ ?Matches any single character.
-
+ []Matches any single character specified within the brackets. For
example, the pattern string 'tty[SR]' would match either 'ttyS' or 'ttyR'.
@@ -322,7 +302,7 @@
The following keys can get values assigned:
-
+
@@ -354,7 +334,7 @@
-
+ , , The permissions for the device node. Every specified value overrides
the compiled-in default value.
@@ -392,14 +372,31 @@
-
+
- Add a program to the list of programs to be executed for a specific
- device.
- If no absolute path is given, the program is expected to live in
- /usr/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.
+ Add a program to the list of programs to be executed after processing all the
+ rules for a specific event, depending on type:
+
+
+ program
+
+ Execute an external program specified as the assigned
+ value. If no absolute path is given, the program is expected to live in
+ /usr/lib/udev, otherwise the absolute path must be specified.
+ This is the default if no type is
+ specified.
+
+
+
+ builtin
+
+ As , but use one of the built-in programs rather
+ than an external one.
+
+
+
+ The program name and following arguments are separated by spaces.
+ Single quotes can be used to specify arguments with spaces.This can only be used for very short-running foreground tasks. Running an
event process for a long period of time may block all further events for
this or a dependent device.
@@ -427,10 +424,10 @@
Import a set of variables as device properties,
- depending on type:
+ depending on type:
-
+ programExecute an external program specified as the assigned value and
import its output, which must be in environment key
@@ -439,14 +436,21 @@
-
+ builtin
+
+ As , but use one of the built-in programs rather
+ than an external one.
+
+
+
+ fileImport a text file specified as the assigned value, the content
of which must be in environment key format.
-
+ dbImport a single property specified as the assigned value from the
current device database. This works only if the database is already populated
@@ -454,14 +458,14 @@
-
+ cmdlineImport a single property from the kernel command line. For simple flags
the value of the property is set to '1'.
-
+ parentImport the stored keys from the parent device by reading
the database entry of the parent device. The value assigned to
@@ -489,7 +493,7 @@
Rule and device options:
-
+
@@ -546,7 +550,7 @@
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:
-
+ ,
@@ -677,20 +681,19 @@
-
+ %%The '%' character itself.
-
+ $$The '$' character itself.
-