X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.link.xml;h=33822e75e256531c309ef9508ec053d990b9c356;hp=c1176ba1762fd70b1d8cc7850c8a13dfd0fb8d95;hb=f131770b1465fbf423881f16ba85523a05f846fe;hpb=1ff28eaee33d9d0cee46bd176b6d6f8805c95036 diff --git a/man/systemd.link.xml b/man/systemd.link.xml index c1176ba17..33822e75e 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, @@ -76,6 +76,10 @@ [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. + + + + [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 +92,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 +172,11 @@ + + + + [Link] Section Options + The [Link] section accepts the following keys: @@ -186,7 +207,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 +243,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 +276,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 +285,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 +360,7 @@ magic - Wake on receipt of a magic packet + Wake on receipt of a magic packet.