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=718eb8efdb5bceb35f3537c41f45a29a52978c6a;hpb=d86dd07d462fb8502b1c7b4a9a4df4fba8318bdd;p=elogind.git diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 718eb8efd..ecf7954d1 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -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. @@ -348,25 +385,23 @@ Example - /etc/systemd/network/bridge.netdev + /etc/systemd/network/wireless.link - [NetDev] -Name=bridge0 -Kind=bridge - - + [Match] +MACAddress=12:34:56:78:9a:bc +Driver=brcmsmac +Path=pci-0000:02:00.0-* +Type=wlan +Virtualization=no +Host=my-laptop +Architecture=x86-64 - - Example - - /etc/systemd/network/vlan1.netdev - - [NetDev] -Name=vlan1 -Kind=vlan - -[VLAN] -Id=1 +[Link] +Name=wireless0 +MTUBytes=1450 +BitsPerSecond=10M +WakeOnLan=magic +MACAddress=cb:a9:87:65:43:21 @@ -378,6 +413,12 @@ Id=1 , udevadm8 + , + + systemd.netdev5 + , + + systemd.network5