man: update explanation for boolean options

This commit is contained in:
Yu Watanabe 2018-11-27 15:07:58 +09:00
parent 025314d97d
commit 9b6ffef372
3 changed files with 93 additions and 102 deletions

View File

@ -364,10 +364,10 @@
<varlistentry>
<term><varname>AutoNegotiation=</varname></term>
<listitem>
<para>Enables or disables automatic negotiation of transmission parameters.
<para>Takes a boolean. If set to yes, automatic negotiation of transmission parameters is enabled.
Autonegotiation is a procedure by which two connected ethernet devices choose
common transmission parameters, such as speed, duplex mode, and flow control.
Takes a boolean value. When unset, the kernel's default will be used.</para>
When unset, the kernel's default will be used.</para>
<para>Note that if autonegotiation is enabled, speed, duplex and advertise settings are
read-only. If autonegotation is disabled, speed, duplex and advertise settings are writable
@ -551,40 +551,35 @@
<varlistentry>
<term><varname>TCPSegmentationOffload=</varname></term>
<listitem>
<para>The TCP Segmentation Offload (TSO) when true enables
TCP segmentation offload. Takes a boolean value.
<para>Takes a boolean. If set to true, the TCP Segmentation Offload (TSO) is enabled.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>TCP6SegmentationOffload=</varname></term>
<listitem>
<para>The TCP6 Segmentation Offload (tx-tcp6-segmentation) when true enables
TCP6 segmentation offload. Takes a boolean value.
<para>Takes a boolean. If set to true, the TCP6 Segmentation Offload (tx-tcp6-segmentation) is enabled.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>GenericSegmentationOffload=</varname></term>
<listitem>
<para>The Generic Segmentation Offload (GSO) when true enables
generic segmentation offload. Takes a boolean value.
<para>Takes a boolean. If set to true, the Generic Segmentation Offload (GSO) is enabled.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>GenericReceiveOffload=</varname></term>
<listitem>
<para>The Generic Receive Offload (GRO) when true enables
generic receive offload. Takes a boolean value.
<para>Takes a boolean. If set to true, the Generic Receive Offload (GRO) is enabled.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>LargeReceiveOffload=</varname></term>
<listitem>
<para>The Large Receive Offload (LRO) when true enables
large receive offload. Takes a boolean value.
<para>Takes a boolean. If set to true, the Large Receive Offload (LRO) is enabled.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>

View File

@ -368,7 +368,7 @@
<varlistentry>
<term><varname>MulticastQuerier=</varname></term>
<listitem>
<para>A boolean. This setting controls the IFLA_BR_MCAST_QUERIER option in the kernel.
<para>Takes a boolean. This setting controls the IFLA_BR_MCAST_QUERIER option in the kernel.
If enabled, the kernel will send general ICMP queries from a zero source address.
This feature should allow faster convergence on startup, but it causes some
multicast-aware switches to misbehave and disrupt forwarding of multicast packets.
@ -379,7 +379,7 @@
<varlistentry>
<term><varname>MulticastSnooping=</varname></term>
<listitem>
<para>A boolean. This setting controls the IFLA_BR_MCAST_SNOOPING option in the kernel.
<para>Takes a boolean. This setting controls the IFLA_BR_MCAST_SNOOPING option in the kernel.
If enabled, IGMP snooping monitors the Internet Group Management Protocol (IGMP) traffic
between hosts and multicast routers. When unset, the kernel's default will be used.
</para>
@ -388,7 +388,7 @@
<varlistentry>
<term><varname>VLANFiltering=</varname></term>
<listitem>
<para>A boolean. This setting controls the IFLA_BR_VLAN_FILTERING option in the kernel.
<para>Takes a boolean. This setting controls the IFLA_BR_VLAN_FILTERING option in the kernel.
If enabled, the bridge will be started in VLAN-filtering mode. When unset, the kernel's default will be used.
</para>
</listitem>
@ -396,7 +396,7 @@
<varlistentry>
<term><varname>STP=</varname></term>
<listitem>
<para>A boolean. This enables the bridge's Spanning Tree Protocol (STP).
<para>Takes a boolean. This enables the bridge's Spanning Tree Protocol (STP).
When unset, the kernel's default will be used.
</para>
</listitem>
@ -422,8 +422,8 @@
<varlistentry>
<term><varname>GVRP=</varname></term>
<listitem>
<para>The Generic VLAN Registration Protocol (GVRP) is a protocol that
allows automatic learning of VLANs on a network. A boolean.
<para>Takes a boolean. The Generic VLAN Registration Protocol (GVRP) is a protocol that
allows automatic learning of VLANs on a network.
When unset, the kernel's default will be used.
</para>
</listitem>
@ -431,26 +431,26 @@
<varlistentry>
<term><varname>MVRP=</varname></term>
<listitem>
<para>Multiple VLAN Registration Protocol (MVRP) formerly known as GARP VLAN
<para>Takes a boolean. Multiple VLAN Registration Protocol (MVRP) formerly known as GARP VLAN
Registration Protocol (GVRP) is a standards-based Layer 2 network protocol,
for automatic configuration of VLAN information on switches. It was defined
in the 802.1ak amendment to 802.1Q-2005. A boolean. When unset, the kernel's default will be used.
in the 802.1ak amendment to 802.1Q-2005. When unset, the kernel's default will be used.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>LooseBinding=</varname></term>
<listitem>
<para>The VLAN loose binding mode, in which only the operational state is passed
<para>Takes a boolean. The VLAN loose binding mode, in which only the operational state is passed
from the parent to the associated VLANs, but the VLAN device state is not changed.
A boolean. When unset, the kernel's default will be used.</para>
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>ReorderHeader=</varname></term>
<listitem>
<para>The VLAN reorder header is set VLAN interfaces behave like physical interfaces.
A boolean. When unset, the kernel's default will be used.</para>
<para>Takes a boolean. The VLAN reorder header is set VLAN interfaces behave like physical interfaces.
When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
</variablelist>
@ -559,7 +559,7 @@
<varlistentry>
<term><varname>MacLearning=</varname></term>
<listitem>
<para>A boolean. When true, enables dynamic MAC learning
<para>Takes a boolean. When true, enables dynamic MAC learning
to discover remote MAC addresses.</para>
</listitem>
</varlistentry>
@ -579,7 +579,7 @@
<varlistentry>
<term><varname>ReduceARPProxy=</varname></term>
<listitem>
<para>A boolean. When true, bridge-connected VXLAN tunnel
<para>Takes a boolean. When true, bridge-connected VXLAN tunnel
endpoint answers ARP requests from the local bridge on behalf
of remote Distributed Overlay Virtual Ethernet
<ulink url="https://en.wikipedia.org/wiki/Distributed_Overlay_Virtual_Ethernet">
@ -589,58 +589,58 @@
<varlistentry>
<term><varname>L2MissNotification=</varname></term>
<listitem>
<para>A boolean. When true, enables netlink LLADDR miss
<para>Takes a boolean. When true, enables netlink LLADDR miss
notifications.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>L3MissNotification=</varname></term>
<listitem>
<para>A boolean. When true, enables netlink IP address miss
<para>Takes a boolean. When true, enables netlink IP address miss
notifications.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>RouteShortCircuit=</varname></term>
<listitem>
<para>A boolean. When true, route short circuiting is turned
<para>Takes a boolean. When true, route short circuiting is turned
on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>UDPChecksum=</varname></term>
<listitem>
<para>A boolean. When true, transmitting UDP checksums when doing VXLAN/IPv4 is turned on.</para>
<para>Takes a boolean. When true, transmitting UDP checksums when doing VXLAN/IPv4 is turned on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>UDP6ZeroChecksumTx=</varname></term>
<listitem>
<para>A boolean. When true, sending zero checksums in VXLAN/IPv6 is turned on.</para>
<para>Takes a boolean. When true, sending zero checksums in VXLAN/IPv6 is turned on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>UDP6ZeroChecksumRx=</varname></term>
<listitem>
<para>A boolean. When true, receiving zero checksums in VXLAN/IPv6 is turned on.</para>
<para>Takes a boolean. When true, receiving zero checksums in VXLAN/IPv6 is turned on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>RemoteChecksumTx=</varname></term>
<listitem>
<para>A boolean. When true, remote transmit checksum offload of VXLAN is turned on.</para>
<para>Takes a boolean. When true, remote transmit checksum offload of VXLAN is turned on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>RemoteChecksumRx=</varname></term>
<listitem>
<para>A boolean. When true, remote receive checksum offload in VXLAN is turned on.</para>
<para>Takes a boolean. When true, remote receive checksum offload in VXLAN is turned on.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>GroupPolicyExtension=</varname></term>
<listitem>
<para>A boolean. When true, it enables Group Policy VXLAN extension security label mechanism
<para>Takes a boolean. When true, it enables Group Policy VXLAN extension security label mechanism
across network peers based on VXLAN. For details about the Group Policy VXLAN, see the
<ulink url="https://tools.ietf.org/html/draft-smith-vxlan-group-policy">
VXLAN Group Policy </ulink> document. Defaults to false.</para>
@ -709,19 +709,19 @@
<varlistentry>
<term><varname>UDPChecksum=</varname></term>
<listitem>
<para>A boolean. When true, specifies if UDP checksum is calculated for transmitted packets over IPv4.</para>
<para>Takes a boolean. When true, specifies if UDP checksum is calculated for transmitted packets over IPv4.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>UDP6ZeroChecksumTx=</varname></term>
<listitem>
<para>A boolean. When true, skip UDP checksum calculation for transmitted packets over IPv6.</para>
<para>Takes a boolean. When true, skip UDP checksum calculation for transmitted packets over IPv6.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>UDP6ZeroChecksumRx=</varname></term>
<listitem>
<para>A boolean. When true, allows incoming UDP packets over IPv6 with zero checksum field.</para>
<para>Takes a boolean. When true, allows incoming UDP packets over IPv6 with zero checksum field.</para>
</listitem>
</varlistentry>
<varlistentry>
@ -792,7 +792,7 @@
<varlistentry>
<term><varname>DiscoverPathMTU=</varname></term>
<listitem>
<para>A boolean. When true, enables Path MTU Discovery on
<para>Takes a boolean. When true, enables Path MTU Discovery on
the tunnel.</para>
</listitem>
</varlistentry>
@ -812,7 +812,7 @@
<varlistentry>
<term><varname>CopyDSCP=</varname></term>
<listitem>
<para>A boolean. When true, the Differentiated Service Code
<para>Takes a boolean. When true, the Differentiated Service Code
Point (DSCP) field will be copied to the inner header from
outer header during the decapsulation of an IPv6 tunnel
packet. DSCP is a field in an IP packet that enables different
@ -875,7 +875,7 @@
<varlistentry>
<term><varname>Independent=</varname></term>
<listitem>
<para>A boolean. When true tunnel does not require .network file. Created as "tunnel@NONE".
<para>Takes a boolean. When true tunnel does not require .network file. Created as "tunnel@NONE".
Defaults to <literal>false</literal>.
</para>
</listitem>
@ -883,7 +883,7 @@
<varlistentry>
<term><varname>AllowLocalRemote=</varname></term>
<listitem>
<para>A boolean. When true allows tunnel traffic on <varname>ip6tnl</varname> devices where the remote endpoint is a local host address.
<para>Takes a boolean. When true allows tunnel traffic on <varname>ip6tnl</varname> devices where the remote endpoint is a local host address.
When unset, the kernel's default will be used.
</para>
</listitem>
@ -891,7 +891,7 @@
<varlistentry>
<term><varname>FooOverUDP=</varname></term>
<listitem>
<para>A boolean. Specifies whether <varname>FooOverUDP=</varname> tunnel is to be configured.
<para>Takes a boolean. Specifies whether <varname>FooOverUDP=</varname> tunnel is to be configured.
Defaults to false. For more detail information see
<ulink url="https://lwn.net/Articles/614348">Foo over UDP</ulink></para>
</listitem>
@ -927,7 +927,7 @@
<varlistentry>
<term><varname>SerializeTunneledPackets=</varname></term>
<listitem>
<para>Takes a boolean value. If set to yes, then packets are serialized. Only applies for ERSPAN tunnel.
<para>Takes a boolean. If set to yes, then packets are serialized. Only applies for ERSPAN tunnel.
When unset, the kernel's default will be used.
</para>
</listitem>
@ -1033,7 +1033,7 @@
<variablelist class='network-directives'>
<varlistentry>
<term><varname>OneQueue=</varname></term>
<listitem><para>Takes a boolean argument. Configures whether
<listitem><para>Takes a boolean. Configures whether
all packets are queued at the device (enabled), or a fixed
number of packets are queued at the device and the rest at the
<literal>qdisc</literal>. Defaults to
@ -1042,7 +1042,7 @@
</varlistentry>
<varlistentry>
<term><varname>MultiQueue=</varname></term>
<listitem><para>Takes a boolean argument. Configures whether
<listitem><para>Takes a boolean. Configures whether
to use multiple file descriptors (queues) to parallelize
packets sending and receiving. Defaults to
<literal>no</literal>.</para>
@ -1050,7 +1050,7 @@
</varlistentry>
<varlistentry>
<term><varname>PacketInfo=</varname></term>
<listitem><para>Takes a boolean argument. Configures whether
<listitem><para>Takes a boolean. Configures whether
packets should be prepended with four extra bytes (two flag
bytes and two protocol bytes). If disabled, it indicates that
the packets will be pure IP packets. Defaults to
@ -1059,7 +1059,7 @@
</varlistentry>
<varlistentry>
<term><varname>VNetHeader=</varname></term>
<listitem><para>Takes a boolean argument. Configures
<listitem><para>Takes a boolean. Configures
IFF_VNET_HDR flag for a tap device. It allows sending
and receiving larger Generic Segmentation Offload (GSO)
packets. This may increase throughput significantly.
@ -1440,7 +1440,7 @@
<varlistentry>
<term><varname>AllSlavesActive=</varname></term>
<listitem>
<para>A boolean. Specifies that duplicate frames (received on inactive ports)
<para>Takes a boolean. Specifies that duplicate frames (received on inactive ports)
should be dropped when false, or delivered when true. Normally, bonding will drop
duplicate frames (received on inactive ports), which is desirable for
most users. But there are some times it is nice to allow duplicate

View File

@ -221,8 +221,8 @@
<varlistentry>
<term><varname>ARP=</varname></term>
<listitem>
<para>A boolean. Enables or disables the ARP (low-level Address Resolution Protocol)
for this interface. When unset, the kernel's default will be used.</para>
<para>Takes a boolean. If set to true, the ARP (low-level Address Resolution Protocol)
for this interface is enabled. When unset, the kernel's default will be used.</para>
<para> For example, disabling ARP is useful when creating multiple MACVLAN or VLAN virtual
interfaces atop a single lower-level physical interface, which will then only serve as a
link/"bridge" device aggregating traffic to the same physical link and not participate in
@ -232,20 +232,20 @@
<varlistentry>
<term><varname>Multicast=</varname></term>
<listitem>
<para>A boolean. Enables or disables the multicast flag on the device.</para>
<para>Takes a boolean. If set to true, the multicast flag on the device is enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>AllMulticast=</varname></term>
<listitem>
<para>A boolean. When this flag is set the driver retrieves all multicast packets from the network.
<para>Takes a boolean. If set to true, the driver retrieves all multicast packets from the network.
This happens when multicast routing is enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>Unmanaged=</varname></term>
<listitem>
<para>A boolean. When <literal>yes</literal>, no attempts are
<para>Takes a boolean. When <literal>yes</literal>, no attempts are
made to bring up or configure matching links, equivalent to
when there are no matching network files. Defaults to
<literal>no</literal>.</para>
@ -257,7 +257,7 @@
<varlistentry>
<term><varname>RequiredForOnline=</varname></term>
<listitem>
<para>A boolean. When <literal>yes</literal>, the network is deemed
<para>Takes a boolean. When <literal>yes</literal>, the network is deemed
required when determining whether the system is online when running
<literal>systemd-networkd-wait-online</literal>.
When <literal>no</literal>, the network is ignored when checking for
@ -311,7 +311,7 @@
<varlistentry>
<term><varname>DHCPServer=</varname></term>
<listitem>
<para>A boolean. Enables DHCPv4 server support. Defaults
<para>Takes a boolean. If set to <literal>yes</literal>, DHCPv4 server will be start. Defaults
to <literal>no</literal>. Further settings for the DHCP
server may be set in the <literal>[DHCPServer]</literal>
section described below.</para>
@ -329,7 +329,7 @@
<varlistentry>
<term><varname>IPv4LLRoute=</varname></term>
<listitem>
<para>A boolean. When true, sets up the route needed for
<para>Takes a boolean. If set to true, sets up the route needed for
non-IPv4LL hosts to communicate with IPv4LL-only hosts. Defaults
to false.
</para>
@ -348,7 +348,7 @@
<varlistentry>
<term><varname>LLMNR=</varname></term>
<listitem>
<para>A boolean or <literal>resolve</literal>. When true,
<para>Takes a boolean or <literal>resolve</literal>. When true,
enables <ulink
url="https://tools.ietf.org/html/rfc4795">Link-Local
Multicast Name Resolution</ulink> on the link. When set to
@ -361,7 +361,7 @@
<varlistentry>
<term><varname>MulticastDNS=</varname></term>
<listitem>
<para>A boolean or <literal>resolve</literal>. When true,
<para>Takes a boolean or <literal>resolve</literal>. When true,
enables <ulink
url="https://tools.ietf.org/html/rfc6762">Multicast
DNS</ulink> support on the link. When set to
@ -389,7 +389,7 @@
<varlistentry>
<term><varname>DNSSEC=</varname></term>
<listitem>
<para>A boolean or
<para>Takes a boolean. or
<literal>allow-downgrade</literal>. When true, enables
<ulink
url="https://tools.ietf.org/html/rfc4033">DNSSEC</ulink>
@ -559,8 +559,8 @@
<listitem><para>Configures IP packet forwarding for the
system. If enabled, incoming packets on any network
interface will be forwarded to any other interfaces
according to the routing table. Takes either a boolean
argument, or the values <literal>ipv4</literal> or
according to the routing table. Takes a boolean,
or the values <literal>ipv4</literal> or
<literal>ipv6</literal>, which only enable IP packet
forwarding for the specified address family. This controls
the <filename>net.ipv4.ip_forward</filename> and
@ -608,9 +608,9 @@
</varlistentry>
<varlistentry>
<term><varname>IPv6AcceptRA=</varname></term>
<listitem><para>Enable or disable IPv6 Router Advertisement (RA) reception support for the interface. Takes
a boolean parameter. If true, RAs are accepted; if false, RAs are ignored, independently of the local
forwarding state. When not set, the kernel default is used, and RAs are accepted only when local forwarding
<listitem><para>Takes a boolean. Controls IPv6 Router Advertisement (RA) reception support for the interface.
If true, RAs are accepted; if false, RAs are ignored, independently of the local forwarding state.
If unset, the kernel's default is used, and RAs are accepted only when local forwarding
is disabled for that interface. When RAs are accepted, they may trigger the start of the DHCPv6 client if
the relevant flags are set in the RA data, or if no routers are found on the link.</para>
@ -639,7 +639,7 @@
</varlistentry>
<varlistentry>
<term><varname>IPv4ProxyARP=</varname></term>
<listitem><para>A boolean. Configures proxy ARP for IPv4. Proxy ARP is the technique in which one host,
<listitem><para>Takes a boolean. Configures proxy ARP for IPv4. Proxy ARP is the technique in which one host,
usually a router, answers ARP requests intended for another machine. By "faking" its identity,
the router accepts responsibility for routing packets to the "real" destination. (see <ulink
url="https://tools.ietf.org/html/rfc1027">RFC 1027</ulink>.
@ -648,7 +648,7 @@
</varlistentry>
<varlistentry>
<term><varname>IPv6ProxyNDP=</varname></term>
<listitem><para>A boolean. Configures proxy NDP for IPv6. Proxy NDP (Neighbor Discovery
<listitem><para>Takes a boolean. Configures proxy NDP for IPv6. Proxy NDP (Neighbor Discovery
Protocol) is a technique for IPv6 to allow routing of addresses to a different
destination when peers expect them to be present on a certain physical link.
In this case a router answers Neighbour Advertisement messages intended for
@ -758,7 +758,7 @@
<varlistentry>
<term><varname>ActiveSlave=</varname></term>
<listitem>
<para>A boolean. Specifies the new active slave. The <literal>ActiveSlave=</literal>
<para>Takes a boolean. Specifies the new active slave. The <literal>ActiveSlave=</literal>
option is only valid for following modes:
<literal>active-backup</literal>,
<literal>balance-alb</literal> and
@ -769,7 +769,7 @@
<varlistentry>
<term><varname>PrimarySlave=</varname></term>
<listitem>
<para>A boolean. Specifies which slave is the primary device. The specified
<para>Takes a boolean. Specifies which slave is the primary device. The specified
device will always be the active slave while it is available. Only when the
primary is off-line will alternate devices be used. This is useful when
one slave is preferred over another, e.g. when one slave has higher throughput
@ -784,7 +784,7 @@
<varlistentry>
<term><varname>ConfigureWithoutCarrier=</varname></term>
<listitem>
<para>A boolean. Allows networkd to configure a specific link even if it has no carrier.
<para>Takes a boolean. Allows networkd to configure a specific link even if it has no carrier.
Defaults to false.
</para>
</listitem>
@ -856,7 +856,7 @@
<varlistentry>
<term><varname>HomeAddress=</varname></term>
<listitem>
<para>Takes a boolean argument. Designates this address the "home address" as defined in
<para>Takes a boolean. Designates this address the "home address" as defined in
<ulink url="https://tools.ietf.org/html/rfc6275">RFC 6275</ulink>.
Supported only on IPv6. Defaults to false.</para>
</listitem>
@ -864,7 +864,7 @@
<varlistentry>
<term><varname>DuplicateAddressDetection=</varname></term>
<listitem>
<para>Takes a boolean argument. Do not perform Duplicate Address Detection
<para>Takes a boolean. Do not perform Duplicate Address Detection
<ulink url="https://tools.ietf.org/html/rfc4862">RFC 4862</ulink> when adding this address.
Supported only on IPv6. Defaults to false.</para>
</listitem>
@ -872,7 +872,7 @@
<varlistentry>
<term><varname>ManageTemporaryAddress=</varname></term>
<listitem>
<para>Takes a boolean argument. If true the kernel manage temporary addresses created
<para>Takes a boolean. If true the kernel manage temporary addresses created
from this one as template on behalf of Privacy Extensions
<ulink url="https://tools.ietf.org/html/rfc3041">RFC 3041</ulink>. For this to become
active, the use_tempaddr sysctl setting has to be set to a value greater than zero.
@ -884,7 +884,7 @@
<varlistentry>
<term><varname>PrefixRoute=</varname></term>
<listitem>
<para>Takes a boolean argument. When adding or modifying an IPv6 address, the userspace
<para>Takes a boolean. When adding or modifying an IPv6 address, the userspace
application needs a way to suppress adding a prefix route. This is for example relevant
together with IFA_F_MANAGERTEMPADDR, where userspace creates autoconf generated addresses,
but depending on on-link, no route for the prefix should be added. Defaults to false.</para>
@ -893,7 +893,7 @@
<varlistentry>
<term><varname>AutoJoin=</varname></term>
<listitem>
<para>Takes a boolean argument. Joining multicast group on ethernet level via
<para>Takes a boolean. Joining multicast group on ethernet level via
<command>ip maddr</command> command would not work if we have an Ethernet switch that does
IGMP snooping since the switch would not replicate multicast packets on ports that did not
have IGMP reports for the multicast addresses. Linux vxlan interfaces created via
@ -1011,10 +1011,10 @@
<varlistentry>
<term><varname>GatewayOnlink=</varname></term>
<listitem>
<para>The <literal>GatewayOnlink</literal> option tells the kernel that it does not have
<para>Takes a boolean. If set to true, the kernel does not have
to check if the gateway is reachable directly by the current machine (i.e., the kernel does
not need to check if the gateway is attached to the local network), so that we can insert the
route in the kernel table without it being complained about. A boolean, defaults to <literal>no</literal>.
route in the kernel table without it being complained about. Defaults to <literal>no</literal>.
</para>
</listitem>
</varlistentry>
@ -1119,7 +1119,7 @@
<varlistentry>
<term><varname>QuickAck=</varname></term>
<listitem>
<para>Takes a boolean argument. When true enables TCP quick ack mode for the route. When unset, the kernel's default will be used.
<para>Takes a boolean. When true enables TCP quick ack mode for the route. When unset, the kernel's default will be used.
</para>
</listitem>
</varlistentry>
@ -1175,7 +1175,7 @@
<varlistentry>
<term><varname>Anonymize=</varname></term>
<listitem>
<para>Takes a boolean argument. When true, the options sent to the DHCP server will
<para>Takes a boolean. When true, the options sent to the DHCP server will
follow the <ulink url="https://tools.ietf.org/html/rfc7844">RFC 7844</ulink>
(Anonymity Profiles for DHCP Clients) to minimize disclosure of identifying information.
Defaults to false.</para>
@ -1221,7 +1221,7 @@
<varlistentry>
<term><varname>UseDomains=</varname></term>
<listitem>
<para>Takes a boolean argument, or the special value <literal>route</literal>. When true, the domain name
<para>Takes a boolean, or the special value <literal>route</literal>. When true, the domain name
received from the DHCP server will be used as DNS search domain over this link, similar to the effect of
the <option>Domains=</option> setting. If set to <literal>route</literal>, the domain name received from
the DHCP server will be used for routing DNS queries only, but not for searching, similar to the effect of
@ -1363,7 +1363,7 @@
<varlistentry>
<term><varname>RapidCommit=</varname></term>
<listitem>
<para>A boolean. The DHCPv6 client can obtain configuration parameters from a DHCPv6 server through
<para>Takes a boolean. The DHCPv6 client can obtain configuration parameters from a DHCPv6 server through
a rapid two-message exchange (solicit and reply). When the rapid commit option is enabled by both
the DHCPv6 client and the DHCPv6 server, the two-message exchange is used, rather than the default
four-method exchange (solicit, advertise, request, and reply). The two-message exchange provides
@ -1376,7 +1376,7 @@
<varlistentry>
<term><varname>ForceDHCPv6PDOtherInformation=</varname></term>
<listitem>
<para>A boolean that enforces DHCPv6 stateful mode when the 'Other information' bit is set in
<para>Takes a boolean that enforces DHCPv6 stateful mode when the 'Other information' bit is set in
Router Advertisement messages. By default setting only the 'O' bit in Router Advertisements
makes DHCPv6 request network information in a stateless manner using a two-message Information
Request and Information Reply message exchange.
@ -1413,7 +1413,7 @@
<varlistentry>
<term><varname>UseDomains=</varname></term>
<listitem>
<para>Takes a boolean argument, or the special value <literal>route</literal>. When true, the domain name
<para>Takes a boolean, or the special value <literal>route</literal>. 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 <option>Domains=</option> setting. If set to <literal>route</literal>, the domain name
received via IPv6 RA will be used for routing DNS queries only, but not for searching, similar to the
@ -1489,11 +1489,9 @@
<term><varname>EmitDNS=</varname></term>
<term><varname>DNS=</varname></term>
<listitem><para>Configures whether the DHCP leases handed out
to clients shall contain DNS server information. The
<varname>EmitDNS=</varname> setting takes a boolean argument
and defaults to <literal>yes</literal>. The DNS servers to
pass to clients may be configured with the
<listitem><para>Takes a boolean. Configures whether the DHCP leases handed out
to clients shall contain DNS server information. Defaults to <literal>yes</literal>.
The DNS servers to pass to clients may be configured with the
<varname>DNS=</varname> option, which takes a list of IPv4
addresses. If the <varname>EmitDNS=</varname> option is
enabled but no servers configured, the servers are
@ -1540,10 +1538,8 @@
<term><varname>EmitTimezone=</varname></term>
<term><varname>Timezone=</varname></term>
<listitem><para>Configures whether the DHCP leases handed out
to clients shall contain timezone information. The
<varname>EmitTimezone=</varname> setting takes a boolean
argument and defaults to <literal>yes</literal>. The
<listitem><para>Takes a boolean. Configures whether the DHCP leases handed out
to clients shall contain timezone information. Defaults to <literal>yes</literal>. The
<varname>Timezone=</varname> setting takes a timezone string
(such as <literal>Europe/Berlin</literal> or
<literal>UTC</literal>) to pass to clients. If no explicit
@ -1569,11 +1565,11 @@
<term><varname>Managed=</varname></term>
<term><varname>OtherInformation=</varname></term>
<listitem><para>Controls whether a DHCPv6 server is used to acquire IPv6
addresses on the network link when <varname>Managed=</varname> boolean
<listitem><para>Takes a boolean. Controls whether a DHCPv6 server is used to acquire IPv6
addresses on the network link when <varname>Managed=</varname>
is set to <literal>true</literal> or if only additional network
information can be obtained via DHCPv6 for the network link when
<varname>OtherInformation=</varname> boolean is set to
<varname>OtherInformation=</varname> is set to
<literal>true</literal>. Both settings default to
<literal>false</literal>, which means that a DHCPv6 server is not being
used.</para></listitem>
@ -1582,7 +1578,7 @@
<varlistentry>
<term><varname>RouterLifetimeSec=</varname></term>
<listitem><para>Configures the IPv6 router lifetime in seconds. If set,
<listitem><para>Takes a timespan. Configures the IPv6 router lifetime in seconds. If set,
this host also announces itself in Router Advertisements as an IPv6
router for the network link. When unset, the host is not acting as a router.</para>
</listitem>
@ -1658,7 +1654,7 @@
<term><varname>AddressAutoconfiguration=</varname></term>
<term><varname>OnLink=</varname></term>
<listitem><para>Boolean values to specify whether IPv6 addresses can be
<listitem><para>Takes a boolean to specify whether IPv6 addresses can be
autoconfigured with this prefix and whether the prefix can be used for
onlink determination. Both settings default to <literal>true</literal>
in order to ease configuration.
@ -1698,7 +1694,7 @@
<varlistentry>
<term><varname>UnicastFlood=</varname></term>
<listitem>
<para>A boolean. Controls whether the bridge should flood
<para>Takes a boolean. Controls whether the bridge should flood
traffic for which an FDB entry is missing and the destination
is unknown through this port. When unset, the kernel's default will be used.
</para>
@ -1707,7 +1703,7 @@
<varlistentry>
<term><varname>HairPin=</varname></term>
<listitem>
<para>A boolean. Configures whether traffic may be sent back
<para>Takes a boolean. Configures whether traffic may be sent back
out of the port on which it was received. When this flag is false, and the bridge
will not forward traffic back out of the receiving port.
When unset, the kernel's default will be used.</para>
@ -1716,14 +1712,14 @@
<varlistentry>
<term><varname>UseBPDU=</varname></term>
<listitem>
<para>A boolean. Configures whether STP Bridge Protocol Data Units will be
<para>Takes a boolean. Configures whether STP Bridge Protocol Data Units will be
processed by the bridge port. When unset, the kernel's default will be used.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>FastLeave=</varname></term>
<listitem>
<para>A boolean. This flag allows the bridge to immediately stop multicast
<para>Takes a boolean. This flag allows the bridge to immediately stop multicast
traffic on a port that receives an IGMP Leave message. It is only used with
IGMP snooping if enabled on the bridge. When unset, the kernel's default will be used.</para>
</listitem>
@ -1731,7 +1727,7 @@
<varlistentry>
<term><varname>AllowPortToBeRoot=</varname></term>
<listitem>
<para>A boolean. Configures whether a given port is allowed to
<para>Takes a boolean. Configures whether a given port is allowed to
become a root port. Only used when STP is enabled on the bridge.
When unset, the kernel's default will be used.</para>
</listitem>