X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.link.xml;h=bb3f908288093d3957c0272fefa07b50c74c2318;hp=718eb8efdb5bceb35f3537c41f45a29a52978c6a;hb=bd763d350c7e8bf8b934bd45bc34ac35cdba2a63;hpb=d86dd07d462fb8502b1c7b4a9a4df4fba8318bdd diff --git a/man/systemd.link.xml b/man/systemd.link.xml index 718eb8efd..bb3f90828 100644 --- a/man/systemd.link.xml +++ b/man/systemd.link.xml @@ -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. @@ -348,25 +379,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 +407,12 @@ Id=1 , udevadm8 + , + + systemd.netdev5 + , + + systemd.network5