X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Fsystemd-networkd.service.xml;h=69157b13ef0568a5101af3a69b64fd6f98541dac;hb=a03c5fd2d86c4e3f758a5ca0d98638e5c8bd8d8d;hp=527742cea3db0a93f1e5e910fb177c677c7f942c;hpb=ed7e5fe37d7e3392538844abadbb2903f4d2540f;p=elogind.git
diff --git a/man/systemd-networkd.service.xml b/man/systemd-networkd.service.xml
index 527742cea..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:
+ 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.
+
@@ -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