systemd.network.xml revision d59be2cf702dd29d0bb228013cef801f2e9dd22f
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye This file is part of systemd.
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye Copyright 2013 Tom Gundersen
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye systemd is free software; you can redistribute it and/or modify it
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye under the terms of the GNU Lesser General Public License as published by
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye the Free Software Foundation; either version 2.1 of the License, or
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye (at your option) any later version.
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye systemd is distributed in the hope that it will be useful, but
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye WITHOUT ANY WARRANTY; without even the implied warranty of
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye Lesser General Public License for more details.
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye You should have received a copy of the GNU Lesser General Public License
fe80b749cd764b1f0f72b2f913b1fe10581911c3Knut Anders Hatlen along with systemd; If not, see <http://www.gnu.org/licenses/>.
cf1f7b5e81583dfca30972cfef322266a6928e7fKnut Anders Hatlen<refentry id="systemd.network" conditional='ENABLE_NETWORKD'>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <refentryinfo>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <authorgroup>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye </authorgroup>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye </refentryinfo>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <refnamediv>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye </refnamediv>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <refsynopsisdiv>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <para><filename><replaceable>network</replaceable>.network</filename></para>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye </refsynopsisdiv>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <para>Network setup is performed by
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <para>Network files must have the extension
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <filename>.network</filename>; other extensions are ignored.
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye Networks are applied to links whenever the links appear.</para>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <para>The <filename>.network</filename> files are read from the
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye files located in the system network directory
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <filename>/usr/lib/systemd/network</filename>, the volatile
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye runtime network directory
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <filename>/run/systemd/network</filename> and the local
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye administration network directory
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <filename>/etc/systemd/network</filename>. All configuration files
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye are collectively sorted and processed in lexical order, regardless
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye of the directories in which they live. However, files with
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye identical filenames replace each other. Files in
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <filename>/etc</filename> have the highest priority, files in
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <filename>/run</filename> take precedence over files with the same
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye name in <filename>/usr/lib</filename>. This can be used to
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye override a system-supplied configuration file with a local file if
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye needed; a symlink in <filename>/etc</filename> with the same name
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye as a configuration file in <filename>/usr/lib</filename>, pointing
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye to <filename>/dev/null</filename>, disables the configuration file
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye entirely.</para>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye <para>The network file contains a <literal>[Match]</literal>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye section, which determines if a given network file may be applied
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye to a given device; and a <literal>[Network]</literal> section
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye specifying how the device should be configured. The first (in
0a0811923cbbd2976425db6f4c78eed811c2825bKnut Anders Hatlen lexical order) of the network files that matches a given device
653794abf1d9fda5f111e2401d8bd3ead80cfc83Vladimir Kotal is applied, all later files are ignored, even if they match as
7e33e87b7d6c9a61ff11d23e37c02274b1223ce1Jens Elkner <para>A network file is said to match a device if each of the
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik entries in the <literal>[Match]</literal> section matches, or if
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik the section is empty. The following keys are accepted:</para>
5a0c5ad4116f5a4dd0dd5a0a4e6d02973cd5eef9Lubos Kosco <varlistentry>
d3d2404f9a49bf70b124053feabe666f85ef5361Knut Anders Hatlen </varlistentry>
780cc7d1b57609ff15fb283201e93cb501ebe9e6Jorgen Austvik <varlistentry>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen <para>A whitespace-separated list of shell-style globs
5a0c5ad4116f5a4dd0dd5a0a4e6d02973cd5eef9Lubos Kosco matching the persistent path, as exposed by the udev
0466de7c67573e1ce5e0733325c1e5383270f5d5Knut Anders Hatlen property <literal>ID_PATH</literal>.</para>
0466de7c67573e1ce5e0733325c1e5383270f5d5Knut Anders Hatlen </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
5a0c5ad4116f5a4dd0dd5a0a4e6d02973cd5eef9Lubos Kosco <para>A whitespace-separated list of shell-style globs
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco matching the driver currently bound to the device, as
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik exposed by the udev property <literal>DRIVER</literal>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik of its parent device, or if that is not set the driver
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik as exposed by <literal>ethtool -i</literal> of the
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye device itself.</para>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco </varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <varlistentry>
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik <para>A whitespace-separated list of shell-style globs
5a0c5ad4116f5a4dd0dd5a0a4e6d02973cd5eef9Lubos Kosco matching the device type, as exposed by the udev property
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik </varlistentry>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik <varlistentry>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik <para>A whitespace-separated list of shell-style globs
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik matching the device name, as exposed by the udev property
5a0c5ad4116f5a4dd0dd5a0a4e6d02973cd5eef9Lubos Kosco </varlistentry>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <varlistentry>
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal <para>Matches against the hostname or machine ID of the
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal </varlistentry>
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal <varlistentry>
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal <term><varname>Virtualization=</varname></term>
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal <para>Checks whether the system is executed in a virtualized
b411dcdf67df825303fcb366759169c881936ac9Vladimir Kotal environment and optionally test whether it is a specific
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco implementation. See <literal>ConditionVirtualization=</literal> in
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco </varlistentry>
b34561d2c3d92fac37dbced05ba6a8738e3d20e9Lubos Kosco <varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <term><varname>KernelCommandLine=</varname></term>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <para>Checks whether a specific kernel command line option is
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco set (or if prefixed with the exclamation mark unset). See
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <literal>ConditionKernelCommandLine=</literal> in
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco for details.
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco </varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <para>Checks whether the system is running on a specific
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco architecture. See <literal>ConditionArchitecture=</literal> in
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco for details.
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco </varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco </variablelist>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <para> The <literal>[Link]</literal> section accepts the following keys:</para>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco </varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <varlistentry>
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco <para>The maximum transmission unit in bytes to set for the
474ac6921d21d2e44cf9c1e91f17d6bcbb15c9e8Lubos Kosco device. The usual suffixes K, M, G, are supported and are
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye understood to the base of 1024.</para>
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco </varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen </variablelist>
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco <para>The <literal>[Network]</literal> section accepts the following keys:</para>
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco <varlistentry>
7b046969a1b2565787df8ae3a8126359e8cd6fafTrond Norbye <para>A description of the device. This is only used for
7b046969a1b2565787df8ae3a8126359e8cd6fafTrond Norbye presentation purposes.</para>
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco </varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <para>Enables DHCPv4 and/or DHCPv6 support. Accepts
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal <literal>yes</literal>, <literal>no</literal>,
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal <literal>ipv4</literal>, or <literal>ipv6</literal>.</para>
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal <para>Please note that by default the domain name
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal specified through DHCP is not used for name resolution.
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen See option <option>UseDomains=</option> below.</para>
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco </varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <term><varname>DHCPServer=</varname></term>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <para>A boolean. Enables a basic DHCPv4 server on the
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal device. Mostly useful for handing out leases to container
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco instances.</para>
9cf771c10c134cc953a502f895eaf321ec927f13Lubos Kosco </varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <term><varname>LinkLocalAddressing=</varname></term>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <para>Enables link-local address autoconfiguration. Accepts
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <literal>yes</literal>, <literal>no</literal>,
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal <literal>ipv4</literal>, or <literal>ipv6</literal>. Defaults to
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal </varlistentry>
a5cc1506d5c0704805c6733a46c7f1f8f91ae724Knut Anders Hatlen <varlistentry>
7b046969a1b2565787df8ae3a8126359e8cd6fafTrond Norbye <para>A boolean. When true, sets up the route needed for
7b046969a1b2565787df8ae3a8126359e8cd6fafTrond Norbye non-IPv4LL hosts to communicate with IPv4LL-only hosts. Defaults
7b046969a1b2565787df8ae3a8126359e8cd6fafTrond Norbye </varlistentry>
0e633a1629c696cc57f02d620a8be7a118fd7956Vladimir Kotal <varlistentry>
81a83bbf0a20e99b5b27be2bcc34c5dbb703c898jel+opengrok <para>An IPv6 address with the top 64 bits unset. When set, indicates the
81a83bbf0a20e99b5b27be2bcc34c5dbb703c898jel+opengrok 64 bits interface part of SLAAC IPv6 addresses for this link. By default
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye it is autogenerated.</para>
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen </varlistentry>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik <varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <para>A boolean or <literal>resolve</literal>. When true, enables
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco Link-Local Multicast Name Resolution on the link, when set to
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <literal>resolve</literal> only resolution is enabled, but not
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco announcement. Defaults to true.</para>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco </varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <varlistentry>
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen <para>A boolean. When true, enables LLDP link receive support.
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen </varlistentry>
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen <varlistentry>
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen <para>A port or a list of ports. When set, controls the
5a0c5ad4116f5a4dd0dd5a0a4e6d02973cd5eef9Lubos Kosco behaviour of the current interface. When all ports in the list
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen are in an operational down state, the current interface is brought
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen down. When at least one port has carrier, the current interface
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen is brought up.
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>A static IPv4 or IPv6 address and its prefix length,
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye separated by a <literal>/</literal> character. Specify
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye this key more than once to configure several addresses.
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye The format of the address must be as described in
81a83bbf0a20e99b5b27be2bcc34c5dbb703c898jel+opengrok <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
81a83bbf0a20e99b5b27be2bcc34c5dbb703c898jel+opengrok This is a short-hand for an [Address] section only
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen containing an Address key (see below). This option may be
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen specified more than once.
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>If the specified address is 0.0.0.0 (for IPv4) or
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye [::] (for IPv6), a new address range of the requested size
752fbd3cf33aada419c8258959ff5574d2d2047dTrond Norbye is automatically allocated from a system-wide pool of
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye unused ranges. The allocated range is checked against all
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen current network interfaces and all known network
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen configuration files to avoid address range conflicts. The
7b046969a1b2565787df8ae3a8126359e8cd6fafTrond Norbye default system-wide pool consists of 192.168.0.0/16,
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen 172.16.0.0/12 and 10.0.0.0/8 for IPv4, and fc00::/7 for
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen IPv6. This functionality is useful to manage a large
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen number of dynamically created network interfaces with the
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen same network configuration and automatic address range
2dbc1835e0ae88ad102e2b9a85e5c7b5298b14b6Knut Anders Hatlen assignment.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>The gateway address, which must be in the format
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye described in
9cf297d9a579835e9336d587eaee187ca0954767Knut Anders Hatlen <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco This is a short-hand for a [Route] section only containing
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco a Gateway key. This option may be specified more than
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco once.</para>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco </varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <para>A DNS server address, which must be in the format
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco described in
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco This option may be specified more than once.</para>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco </varlistentry>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco <varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <para>The domains used for DNS resolution over this link.</para>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco </varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <varlistentry>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco <para>An NTP server address. This option may be specified more than once.</para>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco </varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <varlistentry>
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco <listitem><para>Configures IP forwarding for the network
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco interface. If enabled incoming packets on the network
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco interface will be forwarded to other interfaces according to
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco the routing table. Takes either a boolean argument, or the
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco values <literal>ipv4</literal> or <literal>ipv6</literal>,
3c390a5cd6f5baf2ceb8607d33fe66f93b7826baLubos Kosco which only enables IP forwarding for the specified address
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco family, or <literal>kernel</literal>, which preserves existing sysctl settings.
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco This controls the
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco <filename>net.ipv4.conf.<interface>.forwarding</filename>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco <filename>net.ipv6.conf.<interface>.forwarding</filename>
f9fd2b96d1c5ea62664f74da0e34a04b6511a8ffLubos Kosco sysctl options of the network interface (see <ulink
6d7c6f82e644c205bc679ee5b1fa2929ec949963Lubos Kosco url="https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt">ip-sysctl.txt</ulink>
64b763950bf11e9357facbd2b5666631a895c085Trond Norbye for details about sysctl options). Defaults to
2c2a50fade805afbf4a5a880a38648613d7e01aeLubos Kosco <para>Note: unless this option is turned on, or set to <literal>kernel</literal>,
c0550b01024b910b8c1468811c0ea663b10b1372Trond Norbye no IP forwarding is done on this interface, even if this is
20a0bde399487a651cdeb66fc8b44b2212036355Trond Norbye globally turned on in the kernel, with the
523201f786f6b12b7cf54091c6e5be167878cbeeTrond Norbye <filename>net.ipv4.conf.all.forwarding</filename>, and
523201f786f6b12b7cf54091c6e5be167878cbeeTrond Norbye <filename>net.ipv6.conf.all.forwarding</filename> sysctl
523201f786f6b12b7cf54091c6e5be167878cbeeTrond Norbye options.</para>
523201f786f6b12b7cf54091c6e5be167878cbeeTrond Norbye </varlistentry>
523201f786f6b12b7cf54091c6e5be167878cbeeTrond Norbye <varlistentry>
523201f786f6b12b7cf54091c6e5be167878cbeeTrond Norbye <listitem><para>Configures IP masquerading for the network
c0550b01024b910b8c1468811c0ea663b10b1372Trond Norbye interface. If enabled packets forwarded from the network
0a0811923cbbd2976425db6f4c78eed811c2825bKnut Anders Hatlen interface will be appear as coming from the local host.
0a0811923cbbd2976425db6f4c78eed811c2825bKnut Anders Hatlen Takes a boolean argument. Implies
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <term><varname>IPv6PrivacyExtensions=</varname></term>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <listitem><para>Configures use of stateless temporary
8bdb629053c6752f21668f2af5f336109439b15bkrystof.tulinger@oracle.com addresses that change over time (see <ulink
8bdb629053c6752f21668f2af5f336109439b15bkrystof.tulinger@oracle.com url="https://tools.ietf.org/html/rfc4941">RFC 4941</ulink>,
8bdb629053c6752f21668f2af5f336109439b15bkrystof.tulinger@oracle.com Privacy Extensions for Stateless Address Autoconfiguration
0a0811923cbbd2976425db6f4c78eed811c2825bKnut Anders Hatlen in IPv6). Takes a boolean or the special values
a07b2874263e3c5f0cd2e83441719415d53059c2Knut Anders Hatlen <literal>kernel</literal>. When true enables the privacy
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye extensions and prefers temporary addresses over public
a07b2874263e3c5f0cd2e83441719415d53059c2Knut Anders Hatlen addresses. When <literal>prefer-public</literal> enables the
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye privacy extensions, but prefers public addresses over
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye temporary addresses. When false, the privacy extensions
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye remain disabled. When <literal>kernel</literal> the kernel's
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye default setting will be left in place. Defaults to
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>The name of the bridge to add the link to.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>The name of the bond to add the link to.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>The name of a VLAN to create on the link. This
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye option may be specified more than once.</para>
a07b2874263e3c5f0cd2e83441719415d53059c2Knut Anders Hatlen </varlistentry>
a07b2874263e3c5f0cd2e83441719415d53059c2Knut Anders Hatlen <varlistentry>
c6963a7ea2753672325502d342e653700be550a8Lubos Kosco <para>The name of a MACVLAN to create on the link. This
c6963a7ea2753672325502d342e653700be550a8Lubos Kosco option may be specified more than once.</para>
c6963a7ea2753672325502d342e653700be550a8Lubos Kosco </varlistentry>
c6963a7ea2753672325502d342e653700be550a8Lubos Kosco <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>The name of a VXLAN to create on the link. This
c6963a7ea2753672325502d342e653700be550a8Lubos Kosco option may be specified more than once.</para>
85e0595857351c6e22f75b8928967d14cb679ac5Jorgen Austvik </varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <para>The name of a Tunnel to create on the link. This
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik option may be specified more than once.</para>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik </varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik </variablelist>
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik <para>An <literal>[Address]</literal> section accepts the
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik following keys. Specify several <literal>[Address]</literal>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik sections to configure several addresses.</para>
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik <varlistentry>
85e0595857351c6e22f75b8928967d14cb679ac5Jorgen Austvik <para>As in the <literal>[Network]</literal> section. This
85e0595857351c6e22f75b8928967d14cb679ac5Jorgen Austvik key is mandatory.</para>
a3a5f5c0500064f4c6ac3658b1e3e4d838912329Lubos Kosco </varlistentry>
a3a5f5c0500064f4c6ac3658b1e3e4d838912329Lubos Kosco <varlistentry>
85e0595857351c6e22f75b8928967d14cb679ac5Jorgen Austvik <para>The peer address in a point-to-point connection.
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik Accepts the same format as the <literal>Address</literal>
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik </varlistentry>
c7eb123c8b2081a261deff3c401fbf92ddba1b58Jorgen Austvik <varlistentry>
1f17ba9e3c026d75f488227451416bd72a222afeTrond Norbye <para>The broadcast address, which must be in the format
1f17ba9e3c026d75f488227451416bd72a222afeTrond Norbye <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
1f17ba9e3c026d75f488227451416bd72a222afeTrond Norbye This key only applies to IPv4 addresses. If it is not
1f17ba9e3c026d75f488227451416bd72a222afeTrond Norbye given, it is derived from the <literal>Address</literal>
a3a5f5c0500064f4c6ac3658b1e3e4d838912329Lubos Kosco </varlistentry>
a3a5f5c0500064f4c6ac3658b1e3e4d838912329Lubos Kosco <varlistentry>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik </varlistentry>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik </variablelist>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik <para>The <literal>[Route]</literal> section accepts the
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik following keys. Specify several <literal>[Route]</literal>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik sections to configure several routes.</para>
54ba62a2c6e74332ffc742cb23faf21615b5d39fLubos Kosco <varlistentry>
49f592091468eac515dde6139fbc8efa26056b0aJorgen Austvik <para>As in the <literal>[Network]</literal> section.</para>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik </varlistentry>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <varlistentry>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <para>The destination prefix of the route. Possibly
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik followed by a slash and the prefixlength. If omitted, a
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik full-length host route is assumed.</para>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik </varlistentry>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <varlistentry>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <para>The source prefix of the route. Possibly followed by
8a841dc6dc54985806558f1af0542d271d57259fLubos Kosco a slash and the prefixlength. If omitted, a full-length
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik host route is assumed.</para>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik </varlistentry>
8a841dc6dc54985806558f1af0542d271d57259fLubos Kosco <varlistentry>
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <para>The metric of the route. An unsigned integer</para>
fcb68bae47907ba23c545e379c81c3ee6e19f778Lubos Kosco </varlistentry>
fcb68bae47907ba23c545e379c81c3ee6e19f778Lubos Kosco <varlistentry>
2ef63dc9adc693ddad2206d323b0a85a1afe70ecJorgen Austvik <para>The scope of the route. One of the values <literal>global</literal>,
945f4c3c36a15447913781dfb1894b34f2941c57Jorgen Austvik <literal>link</literal> or <literal>host</literal>. Defaults to
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
30637745bf5a7db2ff9684a2536cc9f8c9df2218Lubos Kosco </variablelist>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>The <literal>[DHCP]</literal> section accepts the following keys:</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>When true (the default), the DNS servers received
30637745bf5a7db2ff9684a2536cc9f8c9df2218Lubos Kosco from the DHCP server will be used and take precedence over
30637745bf5a7db2ff9684a2536cc9f8c9df2218Lubos Kosco any statically configured ones.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>This corresponds to the <option>nameserver</option>
30637745bf5a7db2ff9684a2536cc9f8c9df2218Lubos Kosco option in <citerefentry project='man-pages'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>When true (the default), the NTP servers received
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye from the DHCP server will be used by systemd-timesyncd
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye and take precedence over any statically configured ones.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <para>When true, the interface maximum transmission unit
f09d46eefeb5e4db6dc11e02e417b448fa9362a9Jorgen Austvik from the DHCP server will be used on the current link.
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik Defaults to false.</para>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik </varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <term><varname>SendHostname=</varname></term>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <para>When true (the default), the machine's hostname will
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik be sent to the DHCP server.</para>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik </varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <varlistentry>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik <para>When true (the default), the hostname received from
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik the DHCP server will be used as the transient hostname.
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik </varlistentry>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik <varlistentry>
63e0f31920b0818d6f471a066c12da991fb35346Trond Norbye <para>Use this value for the hostname which is sent to the
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik DHCP server, instead of machine's hostname.</para>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik </varlistentry>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik <varlistentry>
ede8ae04a015c7d2ae4916e5bb36813b81cb7c30Jorgen Austvik <para>When true (not the default), the domain name
49180e08afc7cf03413ab108bc71c14e9de1a880Jorgen Austvik received from the DHCP server will be used for DNS
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal resolution over this link. When a name cannot be resolved
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal as specified, the domain name will be used a suffix and
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal name resolution of that will be attempted.</para>
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal <para>This corresponds to the <option>domain</option>
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal option in <citerefentry project='man-pages'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal and should not be enabled on untrusted networks.</para>
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal </varlistentry>
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal <varlistentry>
da3326b2bbe839609b0f5cf91c86698f1523c8a5Vladimir Kotal <para>When true (the default), the static routes will be
afb218f076cae538126a5f931299a82a114a075aKnut Anders Hatlen requested from the DHCP server and added to the routing
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen table with metric of 1024.</para>
780cc7d1b57609ff15fb283201e93cb501ebe9e6Jorgen Austvik </varlistentry>
2f93a8465131cf5f18613f02f25a3663575bfe57Lubos Kosco <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <term><varname>CriticalConnection=</varname></term>
5dd7583c971e0c2c9e99378930d83df43de56098Lubos Kosco <para>When true, the connection will never be torn down
5dd7583c971e0c2c9e99378930d83df43de56098Lubos Kosco even if the DHCP lease expires. This is contrary to the
5dd7583c971e0c2c9e99378930d83df43de56098Lubos Kosco DHCP specification, but may be the best choice if, say,
629f5f1dc42d96d37676b093b89f011f143dad0aJorgen Austvik the root filesystem relies on this connection. Defaults to
780cc7d1b57609ff15fb283201e93cb501ebe9e6Jorgen Austvik false.</para>
629f5f1dc42d96d37676b093b89f011f143dad0aJorgen Austvik </varlistentry>
780cc7d1b57609ff15fb283201e93cb501ebe9e6Jorgen Austvik <varlistentry>
629f5f1dc42d96d37676b093b89f011f143dad0aJorgen Austvik <term><varname>ClientIdentifier=</varname></term>
780cc7d1b57609ff15fb283201e93cb501ebe9e6Jorgen Austvik <para>DHCP client identifier to use. Either <literal>mac</literal>
d5734522e5d6f8e329d005a0f93f8c2f30df9516Trond Norbye to use the MAC address of the link or <literal>duid</literal>
d5734522e5d6f8e329d005a0f93f8c2f30df9516Trond Norbye (the default) to use a RFC4361-compliant Client ID.</para>
780cc7d1b57609ff15fb283201e93cb501ebe9e6Jorgen Austvik </varlistentry>
5dd7583c971e0c2c9e99378930d83df43de56098Lubos Kosco <varlistentry>
d5734522e5d6f8e329d005a0f93f8c2f30df9516Trond Norbye <term><varname>VendorClassIdentifier=</varname></term>
d3d2404f9a49bf70b124053feabe666f85ef5361Knut Anders Hatlen <para>The vendor class identifier used to identify vendor
d3d2404f9a49bf70b124053feabe666f85ef5361Knut Anders Hatlen type and configuration.</para>
afb218f076cae538126a5f931299a82a114a075aKnut Anders Hatlen </varlistentry>
afb218f076cae538126a5f931299a82a114a075aKnut Anders Hatlen <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <term><varname>RequestBroadcast=</varname></term>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>Request the server to use broadcast messages before
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye the IP address has been configured. This is necessary for
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye devices that cannot receive RAW packets, or that cannot
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye receive packets at all before an IP address has been
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye configured. On the other hand, this must not be enabled on
bcae302a5f4b516d2f3c05f657df054e1a0efde7Knut Anders Hatlen networks where broadcasts are filtered out.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>Set the routing metric for routes specified by the
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye DHCP server.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </variablelist>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <para>The <literal>[Bridge]</literal> section accepts the
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal following keys.</para>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <term><varname>UnicastFlood=</varname></term>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <para>A boolean. UnicastFlood configures whether a given port will flood
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal unicast traffic for which there is no FDB entry. By default this
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal flag is off.</para>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal </varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <para> A boolean. Configures whether traffic may be send back
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal out of the port on which it was received. By default, this
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal flag is false. and the bridge will not forward traffic back
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal out of the receiving port. By default the flag is off.</para>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal </varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <para> A boolean. Configures whether STP Bridge Protocol Data Units will be
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal processed by the bridge port. By default, the flag is false allowing BPDU
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal processing. Turning this flag on will cause the port to stop processing
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal STP Bridge Protocol Data Units. By default the flag is off.</para>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal </varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <varlistentry>
0fbfe32f2fe7b0faa283441ba59f99ea05691d9dVladimir Kotal <para> A boolean. This flag allows the bridge to immediately stop multicast
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye traffic on a port that receives IGMP Leave message. It is only used with
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye IGMP snooping if enabled on the bridge. By default the flag is off.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen <para> A boolean. Configures whether a given port is allowed to
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye become root port or not. Only used when STP is enabled on the bridge.
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye By default the flag is off.</para>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye </varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <varlistentry>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen <para>Each port in a bridge may have different speed. Cost
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen is used to decide which link to use. Faster interfaces
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen should have lower costs</para>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen </varlistentry>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen </variablelist>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen <title>[BridgeFDB] Section Options</title>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen <para>The <literal>[BridgeFDB]</literal> section manages the
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen forwarding database table of a port and accepts the following
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen keys. Specify several <literal>[BridgeFDB]</literal> sections to
d3d2404f9a49bf70b124053feabe666f85ef5361Knut Anders Hatlen configure several static MAC table entries.</para>
5dd7583c971e0c2c9e99378930d83df43de56098Lubos Kosco <varlistentry>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <para>As in the <literal>[Network]</literal> section. This
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye key is mandatory.</para>
7b9f9a1761f76744fc3772181877d5e301f122adKnut Anders Hatlen </varlistentry>
7ecd52b03dc1f0b03ff8f522b4891c8531896c3dJorgen Austvik <varlistentry>
4c0668d038ecec0f5f4f4cc3d7a177d8e118c955Knut Anders Hatlen <para>The VLAN Id for the new static MAC table entry. If
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik omitted, no VLAN Id info is appended to the new static MAC
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik table entry.</para>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik </varlistentry>
2e3c025fdd5908a27cc82eb1d5346368a8be4e0dJorgen Austvik </variablelist>
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen Austvik <title>/etc/systemd/network/50-static.network</title>
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen Austvik <programlisting>[Match]
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen AustvikGateway=192.168.0.1</programlisting>
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen Austvik <title>/etc/systemd/network/80-dhcp.network</title>
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen Austvik <programlisting>[Match]
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen AustvikDHCP=yes</programlisting>
92ed85d851c9108d821e93d3aacc9faf3588e17eJorgen Austvik <title>/etc/systemd/network/bridge-static.network</title>
8a667c39dc64db336c7bd14db6bde1e38fb5c117Knut Anders Hatlen <programlisting>[Match]
8a667c39dc64db336c7bd14db6bde1e38fb5c117Knut Anders HatlenGateway=192.168.0.1
8a667c39dc64db336c7bd14db6bde1e38fb5c117Knut Anders HatlenDNS=192.168.0.1</programlisting>
d3aa2b921c67d952f62c82503575ea545e274d69Knut Anders Hatlen <title>/etc/systemd/network/bridge-slave-interface.network</title>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <programlisting>[Match]
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond NorbyeBridge=bridge0</programlisting>
d3aa2b921c67d952f62c82503575ea545e274d69Knut Anders Hatlen <title>/etc/systemd/network/ipip.network</title>
7e33e87b7d6c9a61ff11d23e37c02274b1223ce1Jens Elkner <programlisting>[Match]
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond NorbyeTunnel=ipip-tun</programlisting>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <title>/etc/systemd/network/sit.network</title>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <programlisting>[Match]
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond NorbyeTunnel=sit-tun</programlisting>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <title>/etc/systemd/network/gre.network</title>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <programlisting>[Match]
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond NorbyeTunnel=gre-tun</programlisting>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <title>/etc/systemd/network/vti.network</title>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <programlisting>[Match]
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond NorbyeTunnel=vti-tun</programlisting>
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
d4ce228a333ba2daa19ad8b0672a704c8e42a2dcTrond Norbye <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>