X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.link.xml;h=ecf7954d1b3c26b95aa5770282361c4d3d428d74;hb=78eb158a20e2bee772f6e49d8b432b98f68cbb55;hp=c1176ba1762fd70b1d8cc7850c8a13dfd0fb8d95;hpb=1ff28eaee33d9d0cee46bd176b6d6f8805c95036;p=elogind.git diff --git a/man/systemd.link.xml b/man/systemd.link.xml index c1176ba17..ecf7954d1 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -53,12 +53,12 @@ Description - Network link configuration is performed by the net_setup_link + 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 + 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, @@ -71,11 +71,21 @@ /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. + The link file contains a + [Match] section, which determines + if a given link file may be applied to a given device, + as well as 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. Note that a default file + 99-default.link is shipped by the + system, any user-supplied .link + should hence have a lexically earlier name to be + considered at all. + + + + [Match] Section Options 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. @@ -88,20 +98,32 @@ The hardware address. + + OriginalName= + + The device name, as exposed by the udev + property "INTERFACE". May contain shell style + globs. This can not be used to match on names + that have already been changed from userspace. + Caution is advised when matching on + kernel-assigned names, as they are known to + be unstable between reboots. + + Path= - The persistent path, as exposed by the - udev property ID_PATH. May - contain shell style globs. - + 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 + of its parent device, or if that is not set, the driver as exposed by ethtool -i of the device itself. @@ -156,6 +178,11 @@ + + + + [Link] Section Options + The [Link] section accepts the following keys: @@ -186,7 +213,7 @@ If the hardware has a persistent MAC address, as most hardware should, - and this is used by the kernel, nothing + and if it 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 @@ -222,22 +249,32 @@ be set. NamePolicy may be disabled by specifying net.ifnames=0 on the kernel - commandline. Each of the policies may fail, and + command line. 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: + NAME. If the name has already + been set by userspace, no renaming is performed. + The available policies are: + + kernel + + If the kernel claims that the name it + has set for a device is predictable, then + no renaming is performed. + + + database The name is set based on entries in the udev's Hardware Database with the key - ID_NET_NAME_FROM_DATABASE - . + ID_NET_NAME_FROM_DATABASE. + @@ -245,8 +282,8 @@ 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 - . + the udev property ID_NET_NAME_ONBOARD. + @@ -254,8 +291,8 @@ 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 - . + the udev property ID_NET_NAME_SLOT. + @@ -329,7 +366,7 @@ magic - Wake on receipt of a magic packet + Wake on receipt of a magic packet. @@ -376,6 +413,12 @@ MACAddress=cb:a9:87:65:43:21 , udevadm8 + , + + systemd.netdev5 + , + + systemd.network5