X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.network.xml;h=484d6f31c78dc76b3c0103442215f69a05b0e0d8;hp=21f6d50cc76911cf27844a5ba865dd9bc68b3e26;hb=cb9fc36a1211967e8c58b0502a26c42552ac8060;hpb=8d0e0ddda6501479eb69164687c83c1a7667b33a
diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 21f6d50cc..484d6f31c 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -179,6 +179,30 @@
+
+ [Link] Section Options
+
+ The [Link] section accepts the following keys:
+
+
+
+ MACAddress=
+
+ The hardware address.
+
+
+
+ MTUBytes=
+
+ The maximum transmission unit in bytes to
+ set for the device. The usual suffixes K, M, G,
+ are supported and are understood to the base of
+ 1024.
+
+
+
+
+
[Network] Section Options
@@ -195,16 +219,48 @@
DHCP=
- A boolean. When true, enables basic DHCPv4 support.
+ Enables DHCPv4 and/or DHCPv6 support. Accepts
+ yes, no,
+ ipv4 or ipv6.
+
+
+
+ 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, acquiring DHCP address
- will deprecate previously acquired IPv4 link-local address or
- stop acquiring process if one has not been acquired before.
+
+
+
+
+ IPv4LLRoute=
+
+ A boolean. When true, sets up the route needed for
+ non-IPv4LL hosts to communicate with IPv4LL-only hosts. Defaults
+ to false.
+
+
+
+
+ LLMNR=
+
+ A boolean or resolve. When true, enables
+ Link-Local Multicast Name Resolution on the link, when set to
+ resolve only resolution is enabled, but not
+ announcement. Defaults to true.
+
+
+
+ LLDP=
+
+ A boolean. When true, enables LLDP link receive support.
@@ -237,14 +293,14 @@
interfaces and all
known network
configuration files to
- avoid IP range
+ 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::] for
+ and fc00::/7 for
IPv6. This
functionality is
useful to manage a
@@ -276,6 +332,42 @@
This option may be specified more than once.
+
+ Domains=
+
+ The domains used for DNS resolution over this link.
+
+
+
+ NTP=
+
+ An NTP server address. This option may be specified more than once.
+
+
+
+ IPForward=
+ Configures IP
+ forwarding for the network
+ interface. If enabled incoming
+ packets on the network
+ interface will be forwarded to
+ other interfaces according to
+ the routing table. Takes a
+ boolean
+ argument.
+
+
+ IPMasquerade=
+ Configures IP
+ masquerading for the network
+ interface. If enabled packets
+ forwarded from the network
+ interface will be appear as
+ coming from the local
+ host. Takes a boolean
+ argument. Implies
+ IPForward=yes.
+
Bridge=
@@ -302,6 +394,20 @@
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.
+
+
@@ -320,6 +426,13 @@
As in the [Network] section. This key is mandatory.
+
+ Peer=
+
+ The peer address in a point-to-point connection. Accepts the same format as
+ the Address key.
+
+
Broadcast=
@@ -347,22 +460,35 @@
Gateway=
- As in the [Network] section. This key is mandatory.
+ As in the [Network] section.
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 omitted, a full-length host route is assumed.
+
+
+
+ Source=
+
+ The source prefix of the route. Possibly followed by a slash and the
+ prefixlength. If omitted, a full-length host route is assumed.
+
+
+
+ Metric=
+
+ The metric of the route. An unsigned integer
- [DHCPv4] Section Options
- The [DHCPv4] section accepts the following keys:
+ [DHCP] Section Options
+ The [DHCP] section accepts the following keys:
@@ -379,6 +505,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=
@@ -386,6 +519,20 @@
will be used as the transient hostname.
+
+ UseDomains=
+
+ When true (not the default), the domain name received from the DHCP server
+ will be used for DNS resolution over this link.
+
+
+
+ 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=
@@ -394,10 +541,66 @@
if, say, the root filesystem relies on this connection. Defaults to false.
+
+ VendorClassIdentifier=
+
+ The vendor class identifier used to identify vendor type and configuration.
+
+
+
+ RequestBroadcast=
+
+ Request the server to use broadcast messages before the IP address has been
+ configured. This is necessary for devices that cannot receive RAW packets, or that
+ cannot receive packets at all before an IP address has been configured. On the other
+ hand, this must not be enabled on networks where broadcasts are filtered out.
+
+
+
+ RouteMetric=
+
+ Set the routing metric for routes specified by the DHCP server.
+
+
+
+ [Bridge] Section Options
+ The [Bridge] section accepts the following keys.
+
+
+ Cost=
+
+ Each port in a bridge may have different speed. Cost is used to decide which link to use. Faster interfaces should have lower costs
+
+
+
+
+
+
+ [BridgeFDB] Section Options
+ The [BridgeFDB] section manages the forwarding database table of a port and accepts the following keys. Specify
+ several [BridgeFDB] sections to configure several static MAC table entries.
+
+
+
+ MACAddress=
+
+ As in the [Network] section. This key is mandatory.
+
+
+
+ VLANId=
+
+ The VLAN Id for the new static MAC table entry.
+ If omitted, no VLAN Id info is appended to the new static MAC table entry.
+
+
+
+
+
Example
@@ -418,7 +621,7 @@ Gateway=192.168.0.1
Name=en*
[Network]
-DHCP=yes
+DHCP=both
@@ -442,6 +645,45 @@ 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
+
@@ -449,6 +691,7 @@ Bridge=bridge0
systemd1,
systemd-networkd8,
+ systemd.link5,
systemd.netdev5