systemd.network.xml revision e2bccc9d9974eb1290653ecfa3ccfd03c313842b
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This file is part of systemd.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Copyright 2013 Tom Gundersen
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann systemd is free software; you can redistribute it and/or modify it
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann under the terms of the GNU Lesser General Public License as published by
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann the Free Software Foundation; either version 2.1 of the License, or
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann (at your option) any later version.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann systemd is distributed in the hope that it will be useful, but
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann WITHOUT ANY WARRANTY; without even the implied warranty of
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Lesser General Public License for more details.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann You should have received a copy of the GNU Lesser General Public License
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann along with systemd; If not, see <http://www.gnu.org/licenses/>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann<refentry id="systemd.network" conditional='ENABLE_NETWORKD'>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refentryinfo>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <authorgroup>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </authorgroup>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </refentryinfo>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refentrytitle>systemd.network</refentrytitle>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refpurpose>Network configuration</refpurpose>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </refnamediv>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <refsynopsisdiv>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para><filename><replaceable>network</replaceable>.network</filename></para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </refsynopsisdiv>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Network setup is performed by
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Network files must have the extension
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>.network</filename>; other extensions are ignored.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Networks are applied to links whenever the links appear.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The <filename>.network</filename> files are read from the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann files located in the system network directory
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>/usr/lib/systemd/network</filename>, the volatile
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann runtime network directory
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>/run/systemd/network</filename> and the local
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann administration network directory
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>/etc/systemd/network</filename>. All configuration files
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann are collectively sorted and processed in lexical order, regardless
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann of the directories in which they live. However, files with
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann identical filenames replace each other. Files in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>/etc</filename> have the highest priority, files in
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <filename>/run</filename> take precedence over files with the same
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann name in <filename>/usr/lib</filename>. This can be used to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann override a system-supplied configuration file with a local file if
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann needed; a symlink in <filename>/etc</filename> with the same name
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann as a configuration file in <filename>/usr/lib</filename>, pointing
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann to <filename>/dev/null</filename>, disables the configuration file
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann entirely.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The network file contains a <literal>[Match]</literal>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann section, which determines if a given network file may be applied
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann to a given device; and a <literal>[Network]</literal> section
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann specifying how the device should be configured. The first (in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann lexical order) of the network files that matches a given device
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann is applied, all later files are ignored, even if they match as
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A network file is said to match a device if each of the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann entries in the <literal>[Match]</literal> section matches, or if
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann the section is empty. The following keys are accepted:</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A whitespace-separated list of shell-style globs
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann matching the persistent path, as exposed by the udev
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A whitespace-separated list of shell-style globs
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann matching the driver currently bound to the device, as
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann exposed by the udev property <literal>DRIVER</literal>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann of its parent device, or if that is not set the driver
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann as exposed by <literal>ethtool -i</literal> of the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann device itself.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A whitespace-separated list of shell-style globs
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann matching the device type, as exposed by the udev property
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A whitespace-separated list of shell-style globs
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann matching the device name, as exposed by the udev property
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Matches against the hostname or machine ID of the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann host. See <literal>ConditionHost=</literal> in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>Virtualization=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Checks whether the system is executed in a virtualized
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann environment and optionally test whether it is a specific
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann implementation. See <literal>ConditionVirtualization=</literal> in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>KernelCommandLine=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Checks whether a specific kernel command line option is
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann set (or if prefixed with the exclamation mark unset). See
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>ConditionKernelCommandLine=</literal> in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>Architecture=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Checks whether the system is running on a specific
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann architecture. See <literal>ConditionArchitecture=</literal> in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para> The <literal>[Link]</literal> section accepts the following keys:</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The maximum transmission unit in bytes to set for the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann device. The usual suffixes K, M, G, are supported and are
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann understood to the base of 1024.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The <literal>[Network]</literal> section accepts the following keys:</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>Description=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A description of the device. This is only used for
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann presentation purposes.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Enables DHCPv4 and/or DHCPv6 support. Accepts
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>yes</literal>, <literal>no</literal>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>ipv4</literal>, or <literal>ipv6</literal>.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Please note that by default the domain name
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann specified through DHCP is not used for name resolution.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann See option <option>UseDomains=</option> below.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A boolean. Enables a basic DHCPv4 server on the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann device. Mostly useful for handing out leases to container
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann instances.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>LinkLocalAddressing=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Enables link-local address autoconfiguration. Accepts
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>yes</literal>, <literal>no</literal>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>ipv4</literal>, or <literal>ipv6</literal>. Defaults to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>IPv4LLRoute=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A boolean. When true, sets up the route needed for
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann non-IPv4LL hosts to communicate with IPv4LL-only hosts. Defaults
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>An IPv6 address with the top 64 bits unset. When set, indicates the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann 64 bits interface part of SLAAC IPv6 addresses for this link. By default
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann it is autogenerated.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A boolean or <literal>resolve</literal>. When true, enables
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Link-Local Multicast Name Resolution on the link, when set to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>resolve</literal> only resolution is enabled, but not
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann announcement. Defaults to true.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A boolean. When true, enables LLDP link receive support.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>BindCarrier=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A port or a list of ports. When set, controls the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann behaviour of the current interface. When all ports in the list
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann are in an operational down state, the current interface is brought
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann down. When at least one port has carrier, the current interface
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann is brought up.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A static IPv4 or IPv6 address and its prefix length,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann separated by a <literal>/</literal> character. Specify
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann this key more than once to configure several addresses.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann The format of the address must be as described in
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This is a short-hand for an [Address] section only
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann containing an Address key (see below). This option may be
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann specified more than once.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>If the specified address is 0.0.0.0 (for IPv4) or
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann [::] (for IPv6), a new address range of the requested size
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann is automatically allocated from a system-wide pool of
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann unused ranges. The allocated range is checked against all
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann current network interfaces and all known network
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann configuration files to avoid address range conflicts. The
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann default system-wide pool consists of 192.168.0.0/16,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann 172.16.0.0/12 and 10.0.0.0/8 for IPv4, and fc00::/7 for
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann IPv6. This functionality is useful to manage a large
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann number of dynamically created network interfaces with the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann same network configuration and automatic address range
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann assignment.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The gateway address, which must be in the format
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This is a short-hand for a [Route] section only containing
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann a Gateway key. This option may be specified more than
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>A DNS server address, which must be in the format
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This option may be specified more than once.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The domains used for DNS resolution over this link.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>An NTP server address. This option may be specified more than once.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <listitem><para>Configures IP forwarding for the network
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann interface. If enabled incoming packets on the network
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann interface will be forwarded to other interfaces according to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann the routing table. Takes either a boolean argument, or the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann values <literal>ipv4</literal> or <literal>ipv6</literal>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann which only enables IP forwarding for the specified address
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann family, or <literal>kernel</literal>, which preserves existing sysctl settings.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This controls the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>net.ipv4.conf.<interface>.forwarding</filename>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <filename>net.ipv6.conf.<interface>.forwarding</filename>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann sysctl options of the network interface (see <ulink
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann url="https://www.kernel.org/doc/Documentation/networking/ip-sysctl.txt">ip-sysctl.txt</ulink>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann for details about sysctl options). Defaults to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>Note: unless this option is turned on, or set to <literal>kernel</literal>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann no IP forwarding is done on this interface, even if this is
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann globally turned on in the kernel, with the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>net.ipv4.conf.all.forwarding</filename>, and
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <filename>net.ipv6.conf.all.forwarding</filename> sysctl
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann options.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>IPMasquerade=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <listitem><para>Configures IP masquerading for the network
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann interface. If enabled packets forwarded from the network
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann interface will be appear as coming from the local host.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Takes a boolean argument. Implies
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varname>IPForward=ipv4</varname>. Defaults to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The name of the bridge to add the link to.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The name of the bond to add the link to.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The name of a VLAN to create on the link. This
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann option may be specified more than once.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The name of a MACVLAN to create on the link. This
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann option may be specified more than once.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The name of a VXLAN to create on the link. This
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann option may be specified more than once.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
7cfa80f07e94c3e48703d145ef03a73dd6e7b983Marcel Holtmann <para>The name of a Tunnel to create on the link. This
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann option may be specified more than once.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>An <literal>[Address]</literal> section accepts the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann following keys. Specify several <literal>[Address]</literal>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann sections to configure several addresses.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>As in the <literal>[Network]</literal> section. This
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann key is mandatory.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The peer address in a point-to-point connection.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann Accepts the same format as the <literal>Address</literal>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The broadcast address, which must be in the format
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <citerefentry project='man-pages'><refentrytitle>inet_pton</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann This key only applies to IPv4 addresses. If it is not
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann given, it is derived from the <literal>Address</literal>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The <literal>[Route]</literal> section accepts the
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann following keys. Specify several <literal>[Route]</literal>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann sections to configure several routes.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>As in the <literal>[Network]</literal> section.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <term><varname>Destination=</varname></term>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The destination prefix of the route. Possibly
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann followed by a slash and the prefixlength. If omitted, a
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann full-length host route is assumed.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The source prefix of the route. Possibly followed by
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann a slash and the prefixlength. If omitted, a full-length
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann host route is assumed.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The metric of the route. An unsigned integer</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The scope of the route. One of the values <literal>global</literal>,
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <literal>link</literal> or <literal>host</literal>. Defaults to
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </variablelist>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>The <literal>[DHCP]</literal> section accepts the following keys:</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>When true (the default), the DNS servers received
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann from the DHCP server will be used and take precedence over
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann any statically configured ones.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <para>This corresponds to the <option>nameserver</option>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann option in <citerefentry project='man-pages'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann </varlistentry>
94f5bbc626f2a4102debd9b17c964170a887cb49Marcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true (the default), the NTP servers received
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann from the DHCP server will be used by systemd-timesyncd
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann and take precedence over any statically configured ones.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true, the interface maximum transmission unit
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann from the DHCP server will be used on the current link.
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann Defaults to false.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>SendHostname=</varname></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true (the default), the machine's hostname will be sent to the DHCP
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann server</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>UseHostname=</varname></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true (the default), the hostname received from
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann the DHCP server will be used as the transient
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann hostname.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true (not the default), the domain name
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann received from the DHCP server will be used for DNS
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann resolution over this link. When a name cannot be resolved
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann as specified, the domain name will be used a suffix and
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann name resolution of that will be attempted.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>This corresponds to the <option>domain</option>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann option in <citerefentry project='man-pages'><refentrytitle>resolv.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann and should not be enabled on untrusted networks.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true (the default), the static routes will be
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann requested from the DHCP server and added to the routing
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann table with metric of 1024.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>CriticalConnection=</varname></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>When true, the connection will never be torn down
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann even if the DHCP lease expires. This is contrary to the
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann DHCP specification, but may be the best choice if, say,
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann the root filesystem relies on this connection. Defaults to
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann false.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>ClientIdentifier=</varname></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>DHCP client identifier to use. Either <literal>mac</literal>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann to use the MAC address of the link or <literal>duid</literal>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann (the default) to use a RFC4361-compliant Client ID.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>VendorClassIdentifier=</varname></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>The vendor class identifier used to identify vendor
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann type and configuration.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <term><varname>RequestBroadcast=</varname></term>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>Request the server to use broadcast messages before
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann the IP address has been configured. This is necessary for
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann devices that cannot receive RAW packets, or that cannot
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann receive packets at all before an IP address has been
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann configured. On the other hand, this must not be enabled on
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann networks where broadcasts are filtered out.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
4b28cdeb2332cfbd3f5172b43a2f5f534b7e6e57Marcel Holtmann <term><varname>RouteMetric=</varname></term>
4b28cdeb2332cfbd3f5172b43a2f5f534b7e6e57Marcel Holtmann <para>Set the routing metric for routes specified by the
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann DHCP server.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </variablelist>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>The <literal>[Bridge]</literal> section accepts the
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann following keys.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>Each port in a bridge may have different speed. Cost
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann is used to decide which link to use. Faster interfaces
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann should have lower costs</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </variablelist>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>The <literal>[BridgeFDB]</literal> section manages the
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann forwarding database table of a port and accepts the following
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann keys. Specify several <literal>[BridgeFDB]</literal> sections to
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann configure several static MAC table entries.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>As in the <literal>[Network]</literal> section. This
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann key is mandatory.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <para>The VLAN Id for the new static MAC table entry. If
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann omitted, no VLAN Id info is appended to the new static MAC
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann table entry.</para>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </varlistentry>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann </variablelist>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <title>/etc/systemd/network/50-static.network</title>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <programlisting>[Match]
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel HoltmannGateway=192.168.0.1</programlisting>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <title>/etc/systemd/network/80-dhcp.network</title>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <programlisting>[Match]
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel HoltmannDHCP=yes</programlisting>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <title>/etc/systemd/network/bridge-static.network</title>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <programlisting>[Match]
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel HoltmannGateway=192.168.0.1
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel HoltmannDNS=192.168.0.1</programlisting>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <title>/etc/systemd/network/bridge-slave-interface.network</title>
5476ad087c0f2d45ab0dab1bab9ef3e9d70418bcMarcel Holtmann <programlisting>[Match]
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel HoltmannBridge=bridge0</programlisting>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <title>/etc/systemd/network/ipip.network</title>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <programlisting>[Match]
b189101727e80a09864c5e5880663ef565467f19Marcel HoltmannTunnel=ipip-tun</programlisting>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <title>/etc/systemd/network/sit.network</title>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <programlisting>[Match]
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel HoltmannTunnel=sit-tun</programlisting>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <title>/etc/systemd/network/gre.network</title>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <programlisting>[Match]
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel HoltmannTunnel=gre-tun</programlisting>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <title>/etc/systemd/network/vti.network</title>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <programlisting>[Match]
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel HoltmannTunnel=vti-tun</programlisting>
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
c6f3f5b4b3ec439ae911ca0644237d96fd31893eMarcel Holtmann <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>