X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.link.xml;h=ecf7954d1b3c26b95aa5770282361c4d3d428d74;hb=5ffa8c818120e35c89becd938d160235c069dd12;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