diff --git a/man/systemd.network.xml b/man/systemd.network.xml index ab08797a9e..eecdeb3e41 100644 --- a/man/systemd.network.xml +++ b/man/systemd.network.xml @@ -2185,219 +2185,240 @@ Table=1234 [IPv6AcceptRA] Section Options - The [IPv6AcceptRA] section configures the IPv6 Router Advertisement (RA) client, if it is enabled - with the IPv6AcceptRA= setting described above: + The [IPv6AcceptRA] section configures the IPv6 Router Advertisement (RA) client, if it is enabled + with the IPv6AcceptRA= setting described above: - - - Token= - - Specifies an optional address generation mode for the Stateless Address - Autoconfiguration (SLAAC). Supported modes are eui64, - static, and prefixstable. + + + Token= + + Specifies an optional address generation mode for the Stateless Address + Autoconfiguration (SLAAC). The following values are supported: - When the mode is set to eui64, then the EUI-64 algorithm will be - used to generate an address for that prefix. + + + + + + The EUI-64 algorithm will be used to generate an address for that prefix. + + + + + + + + An IPv6 address must be specified after a colon (:), and the + lower bits of the supplied address are combined with the upper bits of a prefix + received in a Router Advertisement (RA) message to form a complete address. Note + that if multiple prefixes are received in an RA message, or in multiple RA messages, + addresses will be formed from each of them using the supplied address. This mode + implements SLAAC but uses a static interface identifier instead of an identifier + generated by using the EUI-64 algorithm. Because the interface identifier is static, + if Duplicate Address Detection detects that the computed address is a duplicate + (in use by another node on the link), then this mode will fail to provide an address + for that prefix. If an IPv6 address without mode is specified, then + static mode is assumed. + + + + + + + + The algorithm specified in + RFC 7217 will be used to + generate interface identifiers. This mode can optionally take an IPv6 address + separated with a colon (:). If an IPv6 address is specified, + then an interface identifier is generated only when a prefix received in an RA + message matches the supplied address. + + + Note that the prefixstable algorithm uses both the interface + name and MAC address as input to the hash to compute the interface identifier, so + if either of those are changed the resulting interface identifier (and address) + will be changed, even if the prefix received in the RA message has not been + changed. + + + + - When the mode is set to static, an IPv6 address must be - specified after a colon (:), and the lower bits of the supplied - address are combined with the upper bits of a prefix received in a Router Advertisement - (RA) message to form a complete address. Note that if multiple prefixes are received in an - RA message, or in multiple RA messages, addresses will be formed from each of them using - the supplied address. This mode implements SLAAC but uses a static interface identifier - instead of an identifier generated by using the EUI-64 algorithm. Because the interface - identifier is static, if Duplicate Address Detection detects that the computed address is a - duplicate (in use by another node on the link), then this mode will fail to provide an - address for that prefix. If an IPv6 address without mode is specified, then - static mode is assumed. + If no address generation mode is specified (which is the default), or a received + prefix does not match any of the addresses provided in prefixstable + mode, then the EUI-64 algorithm will be used to form an interface identifier for that + prefix. - When the mode is set to prefixstable the - RFC 7217 algorithm for generating - interface identifiers will be used. This mode can optionally take an IPv6 address separated - with a colon (:). If an IPv6 address is specified, then an interface - identifier is generated only when a prefix received in an RA message matches the supplied - address. + This setting can be specified multiple times. If an empty string is assigned, then + the all previous assignments are cleared. - If no address generation mode is specified (which is the default), or a received - prefix does not match any of the addresses provided in prefixstable - mode, then the EUI-64 algorithm will be used to form an interface identifier for that - prefix. - - Note that the prefixstable algorithm uses both the interface - name and MAC address as input to the hash to compute the interface identifier, so if either - of those are changed the resulting interface identifier (and address) will be changed, even - if the prefix received in the RA message has not been changed. - - This setting can be specified multiple times. If an empty string is assigned, then - the all previous assignments are cleared. - - Examples: - Token=eui64 + Examples: + Token=eui64 Token=::1a:2b:3c:4d Token=static:::1a:2b:3c:4d Token=prefixstable Token=prefixstable:2002:da8:1:: - - + + - - UseDNS= - - When true (the default), the DNS servers received in the Router Advertisement will be used. + + UseDNS= + + When true (the default), the DNS servers received in the Router Advertisement will be used. - This corresponds to the option in resolv.conf5. - - + This corresponds to the option in resolv.conf5. + + - - UseDomains= - - Takes a boolean, or the special value route. When true, the domain name - received via IPv6 Router Advertisement (RA) will be used as DNS search domain over this link, similar to - the effect of the setting. If set to route, the domain name - received via IPv6 RA will be used for routing DNS queries only, but not for searching, similar to the - effect of the setting when the argument is prefixed with - ~. Defaults to false. + + UseDomains= + + Takes a boolean, or the special value route. When true, the domain name + received via IPv6 Router Advertisement (RA) will be used as DNS search domain over this link, similar to + the effect of the setting. If set to route, the domain name + received via IPv6 RA will be used for routing DNS queries only, but not for searching, similar to the + effect of the setting when the argument is prefixed with + ~. Defaults to false. - It is recommended to enable this option only on trusted networks, as setting this affects resolution - of all hostnames, in particular of single-label names. It is generally safer to use the supplied domain - only as routing domain, rather than as search domain, in order to not have it affect local resolution of - single-label names. + It is recommended to enable this option only on trusted networks, as setting this affects resolution + of all hostnames, in particular of single-label names. It is generally safer to use the supplied domain + only as routing domain, rather than as search domain, in order to not have it affect local resolution of + single-label names. - When set to true, this setting corresponds to the option in resolv.conf5. - - + When set to true, this setting corresponds to the option in resolv.conf5. + + - - RouteTable=num - - The table identifier for the routes received in the Router Advertisement - (a number between 1 and 4294967295, or 0 to unset). - The table can be retrieved using ip route show table num. - - - + + RouteTable=num + + The table identifier for the routes received in the Router Advertisement + (a number between 1 and 4294967295, or 0 to unset). + The table can be retrieved using ip route show table num. + + + - - RouteMetric= - - Set the routing metric for the routes received in the Router Advertisement. Takes an - unsigned integer in the range 0…4294967295. Defaults to 1024. - - + + RouteMetric= + + Set the routing metric for the routes received in the Router Advertisement. Takes an + unsigned integer in the range 0…4294967295. Defaults to 1024. + + - - UseMTU= - - Takes a boolean. When true, the MTU received in the Router Advertisement will be - used. Defaults to true. - - + + UseMTU= + + Takes a boolean. When true, the MTU received in the Router Advertisement will be + used. Defaults to true. + + - - UseGateway= - - When true (the default), the router address will be configured as the default gateway. - - - + + UseGateway= + + When true (the default), the router address will be configured as the default gateway. + + + - - UseRoutePrefix= - - When true (the default), the routes corresponding to the route prefixes received in - the Router Advertisement will be configured. - - + + UseRoutePrefix= + + When true (the default), the routes corresponding to the route prefixes received in + the Router Advertisement will be configured. + + - - UseAutonomousPrefix= - - When true (the default), the autonomous prefix received in the Router Advertisement will be used and take - precedence over any statically configured ones. - - + + UseAutonomousPrefix= + + When true (the default), the autonomous prefix received in the Router Advertisement will be used and take + precedence over any statically configured ones. + + - - UseOnLinkPrefix= - - When true (the default), the onlink prefix received in the Router Advertisement will be - used and takes precedence over any statically configured ones. - - + + UseOnLinkPrefix= + + When true (the default), the onlink prefix received in the Router Advertisement will be + used and takes precedence over any statically configured ones. + + - - RouterDenyList= - - A whitespace-separated list of IPv6 router addresses. Each address can optionally - take a prefix length after /. Any information advertised by the listed - router is ignored. - - + + RouterDenyList= + + A whitespace-separated list of IPv6 router addresses. Each address can optionally + take a prefix length after /. Any information advertised by the listed + router is ignored. + + - - RouterAllowList= - - A whitespace-separated list of IPv6 router addresses. Each address can optionally - take a prefix length after /. Only information advertised by the listed - router is accepted. Note that if RouterAllowList= is configured then - RouterDenyList= is ignored. - - + + RouterAllowList= + + A whitespace-separated list of IPv6 router addresses. Each address can optionally + take a prefix length after /. Only information advertised by the listed + router is accepted. Note that if RouterAllowList= is configured then + RouterDenyList= is ignored. + + - - PrefixDenyList= - - A whitespace-separated list of IPv6 prefixes. Each prefix can optionally take its - prefix length after /. IPv6 prefixes supplied via router advertisements - in the list are ignored. - - + + PrefixDenyList= + + A whitespace-separated list of IPv6 prefixes. Each prefix can optionally take its + prefix length after /. IPv6 prefixes supplied via router advertisements + in the list are ignored. + + - - PrefixAllowList= - - A whitespace-separated list of IPv6 prefixes. Each prefix can optionally take its - prefix length after /. IPv6 prefixes supplied via router advertisements - in the list are allowed. Note that if PrefixAllowList= is configured - then PrefixDenyList= is ignored. - - + + PrefixAllowList= + + A whitespace-separated list of IPv6 prefixes. Each prefix can optionally take its + prefix length after /. IPv6 prefixes supplied via router advertisements + in the list are allowed. Note that if PrefixAllowList= is configured + then PrefixDenyList= is ignored. + + - - RouteDenyList= - - A whitespace-separated list of IPv6 route prefixes. Each prefix can optionally take - its prefix length after /. IPv6 route prefixes supplied via router - advertisements in the list are ignored. - - + + RouteDenyList= + + A whitespace-separated list of IPv6 route prefixes. Each prefix can optionally take + its prefix length after /. IPv6 route prefixes supplied via router + advertisements in the list are ignored. + + - - RouteAllowList= - - A whitespace-separated list of IPv6 route prefixes. Each prefix can optionally take - its prefix length after /. IPv6 route prefixes supplied via router - advertisements in the list are allowed. Note that if RouteAllowList= is - configured then RouteDenyList= is ignored. - - + + RouteAllowList= + + A whitespace-separated list of IPv6 route prefixes. Each prefix can optionally take + its prefix length after /. IPv6 route prefixes supplied via router + advertisements in the list are allowed. Note that if RouteAllowList= is + configured then RouteDenyList= is ignored. + + - - DHCPv6Client= - - Takes a boolean, or the special value always. When true, the - DHCPv6 client will be started when the RA has the managed or other information flag. If set - to always, the DHCPv6 client will be started in managed mode when an RA - is received, even if neither managed nor other information flag is set in the RA. This will - be ignored when WithoutRA= in the [DHCPv6] section is enabled, or - UplinkInterface=:self in the [DHCPv6PrefixDelegation] section is - specified. Defaults to true. - - - + + DHCPv6Client= + + Takes a boolean, or the special value always. When true, the + DHCPv6 client will be started when the RA has the managed or other information flag. If set + to always, the DHCPv6 client will be started in managed mode when an RA + is received, even if neither managed nor other information flag is set in the RA. This will + be ignored when WithoutRA= in the [DHCPv6] section is enabled, or + UplinkInterface=:self in the [DHCPv6PrefixDelegation] section is + specified. Defaults to true. + + +