X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fsystemd.network.xml;h=c01bffd52cc4cc3e8ead483c6134bc753d53e214;hp=48e33ac4d43bba9c7d164c3bf331dadf77bded27;hb=b85595b511d3d9f67940f7de0265fb78d672fe81;hpb=d28315e4aff91560ed4c2fc9f876ec8bfc559f2d diff --git a/man/systemd.network.xml b/man/systemd.network.xml index 48e33ac4d..c01bffd52 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,16 +195,32 @@ 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, 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 true. @@ -210,6 +236,43 @@ 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. + @@ -229,6 +292,7 @@ This option may be specified more than once. + Bridge= @@ -255,8 +319,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,12 +351,19 @@ 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= 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. @@ -284,7 +374,10 @@ + + + [Route] Section Options The [Route] section accepts the following keys. Specify several [Route] sections to configure several routes. @@ -299,12 +392,21 @@ 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. + + + + Metric= + + The metric of the route. An unsigned integer + - The [DHCPv4] section accepts the following keys: + + [DHCP] Section Options + The [DHCP] section accepts the following keys: @@ -321,6 +423,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= @@ -328,6 +437,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= @@ -336,6 +452,21 @@ 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. + + @@ -360,7 +491,7 @@ Gateway=192.168.0.1 Name=en* [Network] -DHCP=yes +DHCP=both @@ -384,6 +515,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 +