X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.network.xml;h=2b0eb567be02068683fa8074f2a63dfbdcb26ac7;hp=7609128f3f97a0f1f6ccfa516522a6b46b36aa63;hb=4cc7a82c9490a3c5ae03b1d6d168ce40ba499e23;hpb=06f021a8048583d66202e3ac5cd0a12386d33ac2
diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 7609128f3..2b0eb567b 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -78,6 +78,11 @@
/usr/lib, pointing to /dev/null,
disables the configuration file entirely.
+
+
+
+ [Match] Section Options
+
The network file contains a [Match] section,
which determines if a given network file may be applied to a given device;
and a [Network] section specifying how the device should
@@ -172,6 +177,11 @@
+
+
+
+ [Network] Section Options
+
The [Network] section accepts the following keys:
@@ -185,15 +195,26 @@
DHCP=
- A boolean. When true, enables basic DHCPv4 support.
+ Enables DHCPv4 and/or DHCPv6 support. Accepts
+ both, none,
+ v4 or v6.
+
+
+
+ DHCPServer=
+
+ A boolean. Enables a basic DHCPv4 server on the
+ device. Mostly useful for handing out leases to container
+ instances.
IPv4LL=
A boolean. When true, enables IPv4 link-local support.
- If DHCP= is also true, IPv4 link-local
- address will be removed upon acquiring a DHCP lease.
+ If DHCP= is also true, acquiring DHCP address
+ will deprecate previously acquired IPv4 link-local address or
+ stop acquiring process if one has not been acquired before.
@@ -204,17 +225,57 @@
separated by a / character. Specify this
key more than once to configure several addresses.
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).
+ inet_pton3.
+ This is a short-hand for an [Address] section only containing
+ an Address key (see below). This option may be specified
+ more than once.
+
+ If the specified
+ address is 0.0.0.0
+ (for IPv4) or [::]
+ (for IPv6), a new
+ address range of the
+ requested size is
+ automatically
+ allocated from a
+ system-wide pool of
+ unused ranges. The
+ allocated range is
+ checked against all
+ current network
+ interfaces and all
+ known network
+ configuration files to
+ avoid address range
+ conflicts. The default
+ system-wide pool
+ consists of
+ 192.168.0.0/16,
+ 172.16.0.0/12 and
+ 10.0.0.0/8 for IPv4,
+ and fc00::/7 for
+ IPv6. This
+ functionality is
+ useful to manage a
+ large number of
+ dynamically created
+ network interfaces
+ with the same network
+ configuration and
+ automatic address
+ range
+ assignment.
+
Gateway=
The gateway address, which must be in the format described in
- inet_pton3
- . This is a short-hand for a [Route] section only containing a Gateway key.
+ inet_pton3.
+ This is a short-hand for a [Route] section only containing a Gateway
+ key. This option may be specified more than once.
@@ -222,9 +283,10 @@
A DNS server address, which must be in the format described in
inet_pton3.
- This option may be specified repeatedly.
+ This option may be specified more than once.
+
Bridge=
@@ -251,8 +313,27 @@
may be specified more than once.
+
+ VXLAN=
+
+ The name of a VXLAN to create on the link. This option
+ may be specified more than once.
+
+
+
+ Tunnel=
+
+ The name of a Tunnel to create on the link. This option
+ may be specified more than once.
+
+
+
+
+
+ [Address] Section Options
+
An [Address] section accepts the following keys.
Specify several [Address] sections to configure several
addresses.
@@ -268,8 +349,8 @@
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
+ inet_pton3.
+ This key only applies to IPv4 addresses. If it is not given, it is
derived from the Address key.
@@ -280,7 +361,10 @@
+
+
+ [Route] Section Options
The [Route] section accepts the following keys. Specify
several [Route] sections to configure several routes.
@@ -295,12 +379,15 @@
Destination=
The destination prefix of the route. Possibly followed by a slash and the
- prefixlength, if ommitted a full-length host route is assumed.
+ prefixlength. If ommitted, a full-length host route is assumed.
+
- The [DHCPv4] section accepts the following keys:
+
+ [DHCP] Section Options
+ The [DHCP] section accepts the following keys:
@@ -317,6 +404,13 @@
be used on the current link. Defaults to false.
+
+ SendHostname=
+
+ When true (the default), the machine's hostname will be sent to the DHCP
+ server
+
+
UseHostname=
@@ -324,6 +418,13 @@
will be used as the transient hostname.
+
+ UseRoutes=
+
+ When true (the default), the static routes will be requested from the DHCP server
+ and added to the routing table with metric of 1024.
+
+
CriticalConnection=
@@ -359,13 +460,74 @@ Name=en*
DHCP=yes
+
+ /etc/systemd/network/bridge-static.network
+
+ [Match]
+Name=bridge0
+
+[Network]
+Address=192.168.0.15/24
+Gateway=192.168.0.1
+DNS=192.168.0.1
+
+
+
+ /etc/systemd/network/bridge-slave-interface.network
+
+ [Match]
+Name=enp2s0
+
+[Network]
+Bridge=bridge0
+
+
+ /etc/systemd/network/ipip.network
+
+ [Match]
+Name=em1
+
+[Network]
+Tunnel=ipip-tun
+
+
+
+ /etc/systemd/network/sit.network
+
+ [Match]
+Name=em1
+
+[Network]
+Tunnel=sit-tun
+
+
+
+ /etc/systemd/network/gre.network
+
+ [Match]
+Name=em1
+
+[Network]
+Tunnel=gre-tun
+
+
+
+ /etc/systemd/network/vti.network
+
+ [Match]
+Name=em1
+
+[Network]
+Tunnel=vti-tun
+
See Also
systemd1,
- systemd-networkd8
+ systemd-networkd8,
+ systemd.netdev5