X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fudev.xml;h=a948ea79a94b86ce69f20f826ff668c12eceb6d2;hp=ae7dc61b03ec5c3cd57cf8b531e1d4230e362f3a;hb=0a6f50c0afdfc434b492493bd9efab20cbee8623;hpb=bf175aafd20c9ef974709ef12c5acf836121af33 diff --git a/man/udev.xml b/man/udev.xml index ae7dc61b0..a948ea79a 100644 --- a/man/udev.xml +++ b/man/udev.xml @@ -1,5 +1,4 @@ - - + @@ -113,6 +112,13 @@ + + -= + + Remove the value from a key that holds a list of entries. + + + := @@ -255,7 +261,7 @@ Execute a program to determine whether there is a match; the key is true if the program returns successfully. The device properties are made available to the - executed program in the environment. The program's standard ouput + executed program in the environment. The program's standard output is available in the RESULT key. This can only be used for very short-running foreground tasks. For details, see RUN. @@ -272,8 +278,8 @@ - Most of the fields support shell glob pattern matching. The following - pattern characters are supported: + Most of the fields support shell glob pattern matching and + alternate patterns. The following special characters are supported: * @@ -300,6 +306,14 @@ any characters not enclosed are matched. + + | + + Separates alternative patterns. For example, the pattern string + abc|x* would match either abc + or x*. + + The following keys can get values assigned: @@ -307,8 +321,11 @@ NAME - The name to use for a network interface. The name of a device node - cannot be changed by udev, only additional symlinks can be created. + The name to use for a network interface. See + systemd.link5 + for a higher-level mechanism for setting the interface name. + The name of a device node cannot be changed by udev, only additional + symlinks can be created. @@ -512,13 +529,6 @@ priorities overwrite existing symlinks of other devices. The default is 0. - - - - Number of seconds an event waits for operations to finish before - giving up and terminating itself. - - @@ -724,314 +734,6 @@ - Hardware Database Files - The hwdb files are read from the files located in the - system hwdb directory /usr/lib/udev/hwdb.d, - the volatile runtime directory /run/udev/hwdb.d - and the local administration directory /etc/udev/hwdb.d. - All hwdb files are collectively sorted and processed in lexical order, - regardless of the directories in which they live. However, files with - identical filenames replace each other. Files in /etc - have the highest priority, files in /run take precedence - over files with the same name in /usr/lib. This can be - used to override a system-supplied hwdb file with a local file if needed; - a symlink in /etc with the same name as a hwdb file in - /usr/lib, pointing to /dev/null, - disables the hwdb file entirely. hwdb files must have the extension - .hwdb; other extensions are ignored. - - The hwdb file contains data records consisting of matches and - associated key-value pairs. Every record in the hwdb starts with one or - more match string, specifying a shell glob to compare the database - lookup string against. Multiple match lines are specified in additional - consecutive lines. Every match line is compared indivdually, they are - combined by OR. Every match line must start at the first character of - the line. - - The match lines are followed by one or more key-value pair lines, which - are recognized by a leading space character. The key name and value are separated - by =. An empty line signifies the end - of a record. Lines beginning with # are ignored. - - The content of all hwdb files is read by - udevadm8 - and compiled to a binary database located at /etc/udev/hwdb.bin. - During runtime only the binary database is used. - - - Network Link Configuration - Network link configuration is performed by the net_setup_link - udev builtin. - - The link files are read from the files located in the - system network directory /usr/lib/systemd/network, - the volatile runtime network directory /run/systemd/network - and the local administration network directory /etc/systemd/network. - Link files must have the extension .link; other extensions are ignored. - All link files are collectively sorted and processed in lexical order, - regardless of the directories in which they live. However, files with - identical filenames replace each other. Files in /etc - have the highest priority, files in /run take precedence - over files with the same name in /usr/lib. This can be - used to override a system-supplied link file with a local file if needed; - a symlink in /etc with the same name as a link file in - /usr/lib, pointing to /dev/null, - disables the link file entirely. - - The link file contains a [Match] section, which - determines if a given link file may be applied to a given device; and a - [Link] section specifying how the device should be - configured. The first (in lexical order) of the link files that matches - a given device is applied. - - A link file is said to match a device if each of the entries in the - [Match] section matches, or if the section is empty. - The following keys are accepted: - - - - MACAddress= - - The hardware address. - - - - - Path= - - The persistent path, as exposed by the udev property ID_PATH. - May contain shell style globs. - - - - Driver= - - The driver currently bound to the device, as exposed by the - udev property DRIVER of its parent device, or if - that is not set the driver as exposed by ethtool -i - of the device itself. - - - - Type= - - The device type, as exposed by the udev property DEVTYPE. - - - - Host= - - Matches against the hostname or machine ID of the - host. See ConditionHost= in - systemd.unit5 - for details. - - - - Virtualization= - - Checks whether the system is executed in a virtualized - environment and optionally test whether it is a specific - implementation. See ConditionVirtualization= in - systemd.unit5 - for details. - - - - KernelCommandLine= - - Checks whether a specific kernel command line option is - set (or if prefixed with the exclamation mark unset). See - ConditionKernelCommandLine= in - systemd.unit5 - for details. - - - - Architecture= - - Checks whether the system is running on a specific - architecture. See ConditionArchitecture= in - systemd.unit5 - for details. - - - - - The [Link] section accepts the following keys: - - - - Description= - - A description of the device. - - - - Alias= - - The ifalias is set to this value. - - - - MACAddressPolicy= - - The policy by which the MAC address should be set. The - available policies are: - - - - persistent - - If the hardware has a persistent MAC address, as most - hardware should, and this is used by the kernel, nothing is - done. Otherwise, a new MAC address is generated which is - guaranteed to be the same on every boot for the given - machine and the given device, but which is otherwise random. - - - - - random - - If the kernel is using a random MAC address, nothing is - done. Otherwise, a new address is randomly generated each - time the device appears, typically at boot. - - - - - - - - MACAddress= - - The MAC address to use, if no MACAddressPolicy= - is specified. - - - - - NamePolicy= - - An ordered, space-separated list of policies by which the - interface name should be set. NamePolicy may - be disabled by specifying net.ifnames=0 on the - kernel commandline. Each of the policies may fail, and the first - successful one is used. The name is not set directly, but - is exported to udev as the property ID_NET_NAME, - which is, by default, used by a udev rule to set - NAME. The available policies are: - - - - database - - The name is set based on entries in the Hardware - Database with the key - ID_NET_NAME_FROM_DATABASE. - - - - - onboard - - The name is set based on information given by the - firmware for on-board devices, as exported by the udev - property ID_NET_NAME_ONBOARD. - - - - - slot - - The name is set based on information given by the - firmware for hot-plug devices, as exported by the udev - property ID_NET_NAME_SLOT. - - - - - path - - The name is set based on the device's physical location, - as exported by the udev property - ID_NET_NAME_PATH. - - - - - mac - - The name is set based on the device's persistent MAC - address, as exported by the udev property - ID_NET_NAME_MAC. - - - - - - - - Name= - - The interface name to use in case all the policies specified - in NamePolicy= fail, or in case - NamePolicy= is missing or disabled. - - - - - MTU= - - The MTU to set for the device. - - - - SpeedMBytes= - - The speed to set for the device. - - - - Duplex= - - The duplex mode to set for the device. The accepted values - are half and full. - - - - - WakeOnLan= - - The Wake-on-LAN policy to set for the device. The supported - values are: - - - - phy - - Wake on PHY activity. - - - - magic - - Wake on receipt of a magic packet. - - - - off - - Never wake. - - - - - - - - See Also @@ -1040,6 +742,9 @@ , udevadm8 + , + + systemd.link5