X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd-networkd.service.xml;h=69157b13ef0568a5101af3a69b64fd6f98541dac;hp=48521df2dfef01bcd464bec4586343c6f4886cf2;hb=dfdebb1b925332352966804303b2516a6506a429;hpb=73e231abde39f22097df50542c745e01de879836
diff --git a/man/systemd-networkd.service.xml b/man/systemd-networkd.service.xml
index 48521df2d..69157b13e 100644
--- a/man/systemd-networkd.service.xml
+++ b/man/systemd-networkd.service.xml
@@ -61,11 +61,16 @@
network devices as they appear, as well as creating virtual
network devices.
+ To configure low-level link settings independently of
+ networks, see
+ udev7
+ .
+
Network configurations applied before networkd is started
- are not removed, and configuration applied by networkd are not
- removed when networkd exits. This ensures restarting networkd
- does not cut the network connection, and, in particular, that
- it is safe to transition between the initrd and the real root,
+ are not removed, and static configuration applied by networkd
+ are not removed when networkd exits. This ensures restarting
+ networkd does not cut the network connection, and, in particular,
+ that it is safe to transition between the initrd and the real root,
and back.
@@ -91,6 +96,45 @@
.netdev; other extensions are ignored. Virtual
network devices are created as soon as networkd is started.
+ A virtual network device is only created if the
+ [Match] section matches the current
+ environment, or if the section is empty. The following keys are accepted:
+
+
+
+ Host
+
+ Matches against the hostname or machine ID of the
+ host. See ConditionHost= in
+ systemd.unit5
+ for details.
+
+
+
+
+ Virtualization
+
+ Checks whether the system is executed in a virtualized
+ environment and optionally test whether it is a specific
+ implementation. See ConditionVirtualization= in
+ systemd.unit5
+ for details.
+
+
+
+
+ KernelCommandLine
+
+ Checks whether a specific kernel command line option is
+ set (or if prefixed with the exclamation mark unset). See
+ ConditionKernelCommandLine= in
+ systemd.unit5
+ for details.
+
+
+
+
+
The [NetDev] section accepts the following
keys:
@@ -105,14 +149,15 @@
Kind
- The netdev kind. Currently, 'bridge', 'bond' and 'vlan'
+ The netdev kind. Currently, bridge,
+ bond and vlan
are supported. This option is compulsory.
- The [VLAN] section only applies for netdevs of kind 'vlan',
- and accepts the following keys:
+ The [VLAN] section only applies for netdevs of kind vlan,
+ and accepts the following key:
@@ -152,14 +197,16 @@
Path
The persistent path, as exposed by the udev
- property ID_PATH.
+ property ID_PATH. May contain shell
+ style globs.
Driver
The driver currently bound to the device, as
- exposed by the udev property DRIVER.
+ exposed by the udev property DRIVER
+ of its parent device.
@@ -174,7 +221,40 @@
Name
The device name, as exposed by the udev property
- INTERFACE.
+ INTERFACE. May contain shell style
+ globs.
+
+
+
+ Host
+
+ Matches against the hostname or machine ID of the
+ host. See ConditionHost= in
+ systemd.unit5
+ for details.
+
+
+
+
+ Virtualization
+
+ Checks whether the system is executed in a virtualized
+ environment and optionally test whether it is a specific
+ implementation. See ConditionVirtualization= in
+ systemd.unit5
+ for details.
+
+
+
+
+ KernelCommandLine
+
+ Checks whether a specific kernel command line option is
+ set (or if prefixed with the exclamation mark unset). See
+ ConditionKernelCommandLine= in
+ systemd.unit5
+ for details.
+
@@ -199,7 +279,7 @@
Address
A static IPv4 or IPv6 address and its prefix length,
- separated by a '/' character. The format of the address must
+ separated by a / character. The format of the address must
be as described in
inet_pton3
. This is a short-hand for an [Address] section only containing an Address key (see below).
@@ -251,6 +331,15 @@
As in the [Network] section. This key is mandatory.
+
+ Broadcast
+
+ The broadcast address, which must be in the format described in
+ inet_pton3
+ . This key only applies to IPv4 addresses. If it is not given, it is
+ derived from the Address key.
+
+
Label