diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index e8a164d22d..ded2c0ceff 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -1,4 +1,4 @@
-
+
@@ -223,7 +223,7 @@
DHCP=
- Enables DHCPv4 and/or DHCPv6 support. Accepts
+ Enables DHCPv4 and/or DHCPv6 client support. Accepts
yes, no,
ipv4, or ipv6.
@@ -235,9 +235,10 @@
DHCPServer=
- A boolean. Enables a basic DHCPv4 server on the
- device. Mostly useful for handing out leases to container
- instances.
+ A boolean. Enables DHCPv4 server support. Defaults
+ to no. Further settings for the DHCP
+ server may be set in the [DHCPServer]
+ section described below.
@@ -541,7 +542,9 @@
[DHCP] Section Options
- The [DHCP] section accepts the following keys:
+ The [DHCP] section configures the
+ DHCPv4 and DHCP6 client, if it is enabled with the
+ DHCP= setting described above:
@@ -552,7 +555,8 @@
any statically configured ones.This corresponds to the
- option in resolv.conf5.
+ option in resolv.conf5.
@@ -582,7 +586,7 @@
UseHostname=When true (the default), the hostname received from
- the DHCP server will be used as the transient hostname.
+ the DHCP server will be set as the transient hostname of the system
@@ -615,6 +619,15 @@
table with metric of 1024.
+
+
+ UseTimezone=
+
+ When true, the timezone received from the
+ DHCP server will be set as as timezone of the local
+ system. Defaults to no.
+
+
CriticalConnection=
@@ -658,10 +671,96 @@
DHCP server.
-
+
+
+ [DHCPServer] Section Options
+ The [DHCPServer] section contains
+ settings for the DHCP server, if enabled via the
+ DHCPServer= option described above:
+
+
+
+
+ DefaultLeaseTimeSec=
+ MaxLeaseTimeSec=
+
+ Control the default and maximum DHCP lease
+ time to pass to clients. These settings take time values in seconds or
+ another common time unit, depending on the suffix. The default
+ lease time is used for clients that did not ask for a specific
+ lease time. If a client asks for a lease time longer than the
+ maximum lease time it is automatically shortened to the
+ specified time. The default lease time defaults to 1h, the
+ maximum lease time to 12h. Shorter lease times are beneficial
+ if the configuration data in DHCP leases changes frequently
+ and clients shall learn the new settings with shorter
+ latencies. Longer lease times reduce the generated DHCP
+ network traffic.
+
+
+
+ EmitDNS=
+ DNS=
+
+ Configures whether the DHCP leases handed out
+ to clients shall contain DNS server information. The
+ EmitDNS= setting takes a boolean argument
+ and defaults to yes. The DNS servers to
+ pass to clients may be configured with the
+ DNS= option, which takes a list of IPv4
+ addresses. If the EmitDNS= option is
+ enabled but no servers configured the servers are
+ automatically propagated from an "uplink" interface that has
+ appropriate servers set. The "uplink" interface is determined
+ by the default route of the system with the highest
+ priority. Note that this information is acquired at the time
+ the lease is handed out, and does not take uplink interfaces
+ into account that acquire DNS or NTP server information at a
+ later point. DNS server propagation does not take
+ /etc/resolv.conf into account. Also, note
+ that the leases are not refreshed if uplink network
+ configuration changes. To ensure clients regularly acquire the
+ most current uplink DNS server information it is thus
+ advisable to shorten the DHCP lease time via
+ MaxLeaseTimeSec= described
+ above.
+
+
+
+ EmitNTP=
+ NTP=
+
+ Similar to the EmitDNS= and
+ DNS= settings described above these
+ settings configure whether and what NTP server information
+ shall be emitted as part of the DHCP lease. The same syntax,
+ propagation semantics and defaults apply as for
+ EmitDNS= and
+ DNS=.
+
+
+
+ EmitTimezone=
+ Timezone=
+
+ Configures whether the DHCP leases handed out
+ to clients shall contain timezone information. The
+ EmitTimezone= setting takes a boolean
+ argument and defaults to yes. The
+ Timezone= setting takes a timezone string
+ (such as Europe/Berlin or
+ UTC) to pass to clients. If no explicit
+ timezone is set the system timezone of the local host is
+ propagated, as determined by the
+ /etc/localtime symlink.
+
+
+
+
+
[Bridge] Section OptionsThe [Bridge] section accepts the