X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd.link.xml;h=ecf7954d1b3c26b95aa5770282361c4d3d428d74;hb=d44efb621acfbd09973b7e63246536fd53405d4e;hp=2f5de23742db8fad69ece8283ca3685ce642bac9;hpb=70a44afee385c4afadaab9a002b3f9dd44aedf4a;p=elogind.git
diff --git a/man/systemd.link.xml b/man/systemd.link.xml
index 2f5de2374..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,15 +249,25 @@
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
@@ -376,6 +413,12 @@ MACAddress=cb:a9:87:65:43:21
,
udevadm8
+ ,
+
+ systemd.netdev5
+ ,
+
+ systemd.network5