X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=udev%2Fudev.xml;h=7b31173b21870f6cc159e0331a7d342ec4f44b81;hb=c2e63452dda721bb7f127adefdfe444153a9bdca;hp=48980577c08fbd80a6778535126f6e5fb0454dd7;hpb=0fbda083a2977fe1809467913cc198bbdb681041;p=elogind.git diff --git a/udev/udev.xml b/udev/udev.xml index 48980577c..7b31173b2 100644 --- a/udev/udev.xml +++ b/udev/udev.xml @@ -41,8 +41,8 @@ Configuration - udev configuration files are placed in /etc/udev/ - and /lib/udev/. All empty lines or lines beginning with + udev configuration files are placed in /etc/udev + and /usr/lib/udev. All empty lines or lines beginning with '#' are ignored. Configuration file @@ -71,14 +71,18 @@ Rules files The udev rules are read from the files located in the - default rules directory /lib/udev/rules.d/, - the custom rules directory /etc/udev/rules.d/ - and the temporary rules directory /run/udev/rules.d/. - All rule files are collectively sorted and processed in lexical order, - regardless of the directories in which they live. However, files in - /etc/udev/rules.d/ take precedence over files with - the same name in /lib/udev/rules.d/; this can be - used to ignore a default rules file if needed. + system rules directory /usr/lib/udev/rules.d, + the local administration directory /etc/udev/rules.d + and the volatile runtime directory /run/udev/rules.d. + All rules files are collectively sorted and processed in lexical order, + regardless of the directories in which they live. However, files with + identical file names replace each other. Files in /run + have the highest priority, files in /etc take precedence + over files with the same name in /lib. This can be + used to overwrite a system rules file if needed; a symlink in + /etc with the same name as a rules file in + /lib, pointing to /dev/null, + disables the rules file entirely. Rule files must have the extension .rules; other extensions are ignored. @@ -233,6 +237,13 @@ + + + + Search the devpath upwards for a device with matching tag. + + + @@ -387,7 +398,7 @@ detached from the event process itself. If no absolute path is given, the program is expected to live in the directory provided at compile-time to configure via --libexecdir - (this is usually /lib/udev), otherwise the absolute + (this is usually /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. @@ -456,9 +467,6 @@ - If no option is given, udev chooses between - and based on the executable bit of the file - permissions. @@ -503,7 +511,7 @@ 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 + or copied from /usr/lib/udev/devices. These nodes might not have a corresponding kernel device at the time udevd is started; they can trigger automatic kernel module loading. @@ -511,8 +519,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. @@ -528,10 +536,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: @@ -580,9 +588,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. @@ -612,9 +620,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: @@ -637,8 +645,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. @@ -659,7 +667,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.