eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen<?xml version='1.0'?> <!--*-nxml-*-->
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen<!--
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen This file is part of systemd.
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen Copyright 2013 Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen systemd is free software; you can redistribute it and/or modify it
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen under the terms of the GNU Lesser General Public License as published by
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen the Free Software Foundation; either version 2.1 of the License, or
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen (at your option) any later version.
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen systemd is distributed in the hope that it will be useful, but
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen WITHOUT ANY WARRANTY; without even the implied warranty of
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen Lesser General Public License for more details.
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen You should have received a copy of the GNU Lesser General Public License
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen along with systemd; If not, see <http://www.gnu.org/licenses/>.
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen-->
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen<refentry id="systemd.netdev" conditional='ENABLE_NETWORKD'>
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentryinfo>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>systemd.network</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <authorgroup>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <author>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <contrib>Developer</contrib>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <firstname>Tom</firstname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <surname>Gundersen</surname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <email>teg@jklm.no</email>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </author>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </authorgroup>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refentryinfo>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refmeta>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd.netdev</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <manvolnum>5</manvolnum>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refmeta>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refnamediv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>systemd.netdev</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Virtual Network Device configuration</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refnamediv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename><replaceable>netdev</replaceable>.netdev</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Description</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Network setup is performed by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Virtual Network Device files must have the extension
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>.netdev</filename>; other extensions are ignored.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Virtual network devices are created as soon as networkd is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek started. If a netdev with the specified name already exists,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek networkd will use that as-is rather than create its own. Note that
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the settings of the pre-existing netdev will not be changed by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek networkd.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <filename>.netdev</filename> files are read from the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek files located in the system network directory
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen <filename>/usr/lib/systemd/network</filename>, the volatile
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek runtime network directory
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/run/systemd/network</filename> and the local
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek administration network directory
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen <filename>/etc/systemd/network</filename>. All configuration files
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek are collectively sorted and processed in lexical order, regardless
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek of the directories in which they live. However, files with
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek identical filenames replace each other. Files in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/etc</filename> have the highest priority, files in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/run</filename> take precedence over files with the same
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen name in <filename>/usr/lib</filename>. This can be used to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek override a system-supplied configuration file with a local file if
57e27ec0ada6775d85a5201cd25e989d92d0a1afZbigniew Jędrzejewski-Szmek needed. As a special case, an empty file (file size 0) or symlink
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt with the same name pointing to <filename>/dev/null</filename>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt disables the configuration file entirely (it is "masked").</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Supported netdev kinds</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The following kinds of virtual network devices may be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek configured in <filename>.netdev</filename> files:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <table>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Supported kinds of virtual network devices</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <tgroup cols='2'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <colspec colname='kind' />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <colspec colname='explanation' />
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <thead><row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>Kind</entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>Description</entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </row></thead>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <tbody>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>bond</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A bond device is an aggregation of all its slave devices. See <ulink url="https://www.kernel.org/doc/Documentation/networking/bonding.txt">Linux Ethernet Bonding Driver HOWTO</ulink> for details.Local configuration</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>bridge</varname></entry>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <entry>A bridge device is a software switch, and each of its slave devices and the bridge itself are ports of the switch.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>dummy</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A dummy device drops all packets sent to it.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>gre</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A Level 3 GRE tunnel over IPv4. See <ulink url="https://tools.ietf.org/html/rfc2784">RFC 2784</ulink> for details.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>gretap</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A Level 2 GRE tunnel over IPv4.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>ip6gre</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A Level 3 GRE tunnel over IPv6.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>ip6tnl</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>An IPv4 or IPv6 tunnel over IPv6</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>ip6gretap</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>An Level 2 GRE tunnel over IPv6.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>ipip</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>An IPv4 over IPv4 tunnel.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>ipvlan</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>An ipvlan device is a stacked device which receives packets from its underlying device based on IP address filtering.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>macvlan</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A macvlan device is a stacked device which receives packets from its underlying device based on MAC address filtering.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani <row><entry><varname>macvtap</varname></entry>
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani <entry>A macvtap device is a stacked device which receives packets from its underlying device based on MAC address filtering.</entry></row>
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>sit</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>An IPv6 over IPv4 tunnel.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>tap</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A persistent Level 2 tunnel between a network device and a device node.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>tun</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A persistent Level 3 tunnel between a network device and a device node.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>veth</varname></entry>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <entry>An Ethernet tunnel between a pair of network devices.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>vlan</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A VLAN is a stacked device which receives packets from its underlying device based on VLAN tagging. See <ulink url="http://www.ieee802.org/1/pages/802.1Q.html">IEEE 802.1Q</ulink> for details.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>vti</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>An IPv4 over IPSec tunnel.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
5cc0748e19490c4275aa66796679e3e67b649795Susant Sahani <row><entry><varname>vti6</varname></entry>
5cc0748e19490c4275aa66796679e3e67b649795Susant Sahani <entry>An IPv6 over IPSec tunnel.</entry></row>
5cc0748e19490c4275aa66796679e3e67b649795Susant Sahani
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <row><entry><varname>vxlan</varname></entry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <entry>A virtual extensible LAN (vxlan), for connecting Cloud computing deployments.</entry></row>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </tbody>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </tgroup>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </table>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Match] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A virtual network device is only created if the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>[Match]</literal> section matches the current
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek environment, or if the section is empty. The following keys are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek accepted:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Host=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Matches against the hostname or machine ID of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek host. See <literal>ConditionHost=</literal> in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Virtualization=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Checks whether the system is executed in a virtualized
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek environment and optionally test whether it is a specific
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek implementation. See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ConditionVirtualization=</literal> in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>KernelCommandLine=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Checks whether a specific kernel command line option
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek is set (or if prefixed with the exclamation mark unset). See
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ConditionKernelCommandLine=</literal> in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Architecture=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Checks whether the system is running on a specific
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek architecture. See <literal>ConditionArchitecture=</literal> in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[NetDev] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[NetDev]</literal> section accepts the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following keys:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Description=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A free-form description of the netdev.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Name=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The interface name used when creating the netdev.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek This option is compulsory.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Kind=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The netdev kind. This option is compulsory. See the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>Supported netdev kinds</literal> section for the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek valid keys.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MTUBytes=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The maximum transmission unit in bytes to set for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the device. The usual suffixes K, M, G, are supported and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek are understood to the base of 1024. This key is not
ff9b60f38bf68eba4a47cabff14547d92e083214Torstein Husebø currently supported for <literal>tun</literal> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>tap</literal> devices.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MACAddress=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The MAC address to use for the device. If none is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek given, one is generated based on the interface name and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
ff9b60f38bf68eba4a47cabff14547d92e083214Torstein Husebø This key is not currently supported for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>tun</literal> or <literal>tap</literal> devices.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <refsect1>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <title>[Bridge] Section Options</title>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <para>The <literal>[Bridge]</literal> section only applies for
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani netdevs of kind <literal>bridge</literal>, and accepts the
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt following keys:</para>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <variablelist class='network-directives'>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <varlistentry>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <term><varname>HelloTimeSec=</varname></term>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>HelloTimeSec specifies the number of seconds between two hello packets
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani sent out by the root bridge and the designated bridges. Hello packets are
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani used to communicate information about the topology throughout the entire
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani bridged local area network.</para>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </listitem>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </varlistentry>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <varlistentry>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <term><varname>MaxAgeSec=</varname></term>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <listitem>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <para>MaxAgeSec specifies the number of seconds of maximum message age.
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani If the last seen (received) hello packet is more than this number of
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani seconds old, the bridge in question will start the takeover procedure
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani in attempt to become the Root Bridge itself.</para>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </listitem>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </varlistentry>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <varlistentry>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <term><varname>ForwardDelaySec=</varname></term>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <listitem>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani <para>ForwardDelaySec specifies the number of seconds spent in each
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani of the Listening and Learning states before the Forwarding state is entered.</para>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </listitem>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </varlistentry>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </variablelist>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani </refsect1>
3428fe07f0fc639d2e07297f0c4a2392c9bb2a68Susant Sahani
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[VLAN] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[VLAN]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>vlan</literal>, and accepts the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following key:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Id=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The VLAN ID to use. An integer in the range 0–4094.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek This option is compulsory.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[MACVLAN] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[MACVLAN]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>macvlan</literal>, and accepts the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following key:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Mode=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The MACVLAN mode to use. The supported options are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>private</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>vepa</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>bridge</literal>, and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>passthru</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani <refsect1>
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani <title>[MACVTAP] Section Options</title>
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani <para>The <literal>[MACVTAP]</literal> section applies for
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani netdevs of kind <literal>macvtap</literal> and accepts the
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani same key as <literal>[MACVLAN].</literal> </para>
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani </refsect1>
0371f2df67ca0b48a321d1ee5383a8f11b7e59e6Susant Sahani
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[IPVLAN] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[IPVLAN]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>ipvlan</literal>, and accepts the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following key:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Mode=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The IPVLAN mode to use. The supported options are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>L2</literal> and <literal>L3</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[VXLAN] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[VXLAN]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>vxlan</literal>, and accepts the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek following keys:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Id=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The VXLAN ID to use.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Group=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>An assigned multicast group IP address.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>TOS=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The Type Of Service byte value for a vxlan interface.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>TTL=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A fixed Time To Live N on Virtual eXtensible Local
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt Area Network packets. N is a number in the range 1–255. 0
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek is a special value meaning that packets inherit the TTL
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek value.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MacLearning=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A boolean. When true, enables dynamic MAC learning
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek to discover remote MAC addresses.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>FDBAgeingSec=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The lifetime of Forwarding Database entry learnt by
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt the kernel, in seconds.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
3d276dd2c06815ee1b07c60d85024262455868d1Susant Sahani <term><varname>MaximumFDBEntries=</varname></term>
3d276dd2c06815ee1b07c60d85024262455868d1Susant Sahani <listitem>
3d276dd2c06815ee1b07c60d85024262455868d1Susant Sahani <para>Configures maximum number of FDB entries.</para>
3d276dd2c06815ee1b07c60d85024262455868d1Susant Sahani </listitem>
3d276dd2c06815ee1b07c60d85024262455868d1Susant Sahani </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>ARPProxy=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>A boolean. When true, enables ARP proxying.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>L2MissNotification=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A boolean. When true, enables netlink LLADDR miss
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek notifications.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>L3MissNotification=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>A boolean. When true, enables netlink IP address miss
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek notifications.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>RouteShortCircuit=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>A boolean. When true, route short circuiting is turned
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek on.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <varlistentry>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <term><varname>UDPCheckSum=</varname></term>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <listitem>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>A boolean. When true, transmitting UDP checksums when doing VXLAN/IPv4 is turned on.</para>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani </listitem>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani </varlistentry>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <varlistentry>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <term><varname>UDP6ZeroChecksumTx=</varname></term>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <listitem>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>A boolean. When true, sending zero checksums in VXLAN/IPv6 is turned on.</para>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani </listitem>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani </varlistentry>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <varlistentry>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <term><varname>UDP6ZeroCheckSumRx=</varname></term>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani <listitem>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>A boolean. When true, receiving zero checksums in VXLAN/IPv6 is turned on.</para>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani </listitem>
cffacc741cb79f63999720525ceaa65aae01a542Susant Sahani </varlistentry>
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani <varlistentry>
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani <term><varname>GroupPolicyExtension=</varname></term>
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani <listitem>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>A boolean. When true, it enables Group Policy VXLAN extension security label mechanism
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt across network peers based on VXLAN. For details about the Group Policy VXLAN, see the
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani <ulink url="https://tools.ietf.org/html/draft-smith-vxlan-group-policy">
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani VXLAN Group Policy </ulink> document. Defaults to false.</para>
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani </listitem>
8b414e52d14d1e6bc02db65d0de9ad8e0c5017daSusant Sahani </varlistentry>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <varlistentry>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <term><varname>DestinationPort=</varname></term>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <listitem>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <para>Configures the default destination UDP port on a per-device basis.
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani If destination port is not specified then Linux kernel default will be used.
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani Set destination port 4789 to get the IANA assigned value,
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani and destination port 0 to get default values.</para>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani </listitem>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani </varlistentry>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <varlistentry>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <term><varname>PortRange=</varname></term>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <listitem>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani <para>Configures VXLAN port range. VXLAN bases source
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani UDP port based on flow to help the receiver to be able
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani to load balance based on outer header flow. It
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani restricts the port range to the normal UDP local
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani ports, and allows overriding via configuration.</para>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani </listitem>
ea0288d17c0713eea601ea6c7715a649842d229dSusant Sahani </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Tunnel] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[Tunnel]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ipip</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>sit</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>gre</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>gretap</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ip6gre</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ip6gretap</literal>,
5cc0748e19490c4275aa66796679e3e67b649795Susant Sahani <literal>vti</literal>,
5cc0748e19490c4275aa66796679e3e67b649795Susant Sahani <literal>vti6</literal>, and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ip6tnl</literal> and accepts
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the following keys:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Local=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A static local address for tunneled packets. It must
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek be an address on another interface of this host.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Remote=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The remote endpoint of the tunnel.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>TOS=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The Type Of Service byte value for a tunnel interface.
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt For details about the TOS, see the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <ulink url="http://tools.ietf.org/html/rfc1349"> Type of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Service in the Internet Protocol Suite </ulink> document.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>TTL=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A fixed Time To Live N on tunneled packets. N is a
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt number in the range 1–255. 0 is a special value meaning that
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek packets inherit the TTL value. The default value for IPv4
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt tunnels is: inherit. The default value for IPv6 tunnels is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek 64.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>DiscoverPathMTU=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A boolean. When true, enables Path MTU Discovery on
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the tunnel.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
276de52699a470a4a4a35443df485eb1f666f563Susant Sahani <varlistentry>
276de52699a470a4a4a35443df485eb1f666f563Susant Sahani <term><varname>IPv6FlowLabel=</varname></term>
276de52699a470a4a4a35443df485eb1f666f563Susant Sahani <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>Configures the 20-bit flow label (see <ulink url="https://tools.ietf.org/html/rfc6437">
276de52699a470a4a4a35443df485eb1f666f563Susant Sahani RFC 6437</ulink>) field in the IPv6 header (see <ulink url="https://tools.ietf.org/html/rfc2460">
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt RFC 2460</ulink>), which is used by a node to label packets of a flow.
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt It is only used for IPv6 tunnels.
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt A flow label of zero is used to indicate packets that have
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt not been labeled.
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt It can be configured to a value in the range 0–0xFFFFF, or be
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt set to <literal>inherit</literal>, in which case the original flowlabel is used.</para>
276de52699a470a4a4a35443df485eb1f666f563Susant Sahani </listitem>
276de52699a470a4a4a35443df485eb1f666f563Susant Sahani </varlistentry>
9b0ca30a91b661f56ed7cee5bab02cc5aef6d38bSusant Sahani <varlistentry>
a9b70f9dfd9214ea6934a3ebc1950208eee4d174Zbigniew Jędrzejewski-Szmek <term><varname>CopyDSCP=</varname></term>
9b0ca30a91b661f56ed7cee5bab02cc5aef6d38bSusant Sahani <listitem>
3cf4bcab07c3d6a58251a68b5d969d0a38518209Zbigniew Jędrzejewski-Szmek <para>A boolean. When true, the Differentiated Service Code
3cf4bcab07c3d6a58251a68b5d969d0a38518209Zbigniew Jędrzejewski-Szmek Point (DSCP) field will be copied to the inner header from
a9b70f9dfd9214ea6934a3ebc1950208eee4d174Zbigniew Jędrzejewski-Szmek outer header during the decapsulation of an IPv6 tunnel
3cf4bcab07c3d6a58251a68b5d969d0a38518209Zbigniew Jędrzejewski-Szmek packet. DSCP is a field in an IP packet that enables different
3cf4bcab07c3d6a58251a68b5d969d0a38518209Zbigniew Jędrzejewski-Szmek levels of service to be assigned to network traffic.
3cf4bcab07c3d6a58251a68b5d969d0a38518209Zbigniew Jędrzejewski-Szmek Defaults to <literal>no</literal>.
9b0ca30a91b661f56ed7cee5bab02cc5aef6d38bSusant Sahani </para>
9b0ca30a91b661f56ed7cee5bab02cc5aef6d38bSusant Sahani </listitem>
9b0ca30a91b661f56ed7cee5bab02cc5aef6d38bSusant Sahani </varlistentry>
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani <varlistentry>
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani <term><varname>EncapsulationLimit=</varname></term>
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani <listitem>
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani <para>The Tunnel Encapsulation Limit option specifies how many additional
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani levels of encapsulation are permitted to be prepended to the packet.
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani For example, a Tunnel Encapsulation Limit option containing a limit
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani value of zero means that a packet carrying that option may not enter
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani another tunnel before exiting the current tunnel.
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani (see <ulink url="https://tools.ietf.org/html/rfc2473#section-4.1.1"> RFC 2473</ulink>).
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt The valid range is 0–255 and <literal>none</literal>. Defaults to 4.
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani </para>
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani </listitem>
dae398a8c2a7ee48caf2062eb397b7abab2e1ff2Susant Sahani </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Mode=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>An <literal>ip6tnl</literal> tunnel can be in one of three
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek modes
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ip6ip6</literal> for IPv6 over IPv6,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ipip6</literal> for IPv4 over IPv6 or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>any</literal> for either.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Peer] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[Peer]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>veth</literal> and accepts the
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt following keys:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Name=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The interface name used when creating the netdev.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek This option is compulsory.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MACAddress=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>The peer MACAddress, if not set, it is generated in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the same way as the MAC address of the main
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek interface.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Tun] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[Tun]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>tun</literal>, and accepts the following
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek keys:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>OneQueue=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes a boolean argument. Configures whether
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek all packets are queued at the device (enabled), or a fixed
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek number of packets are queued at the device and the rest at the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>qdisc</literal>. Defaults to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>no</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MultiQueue=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes a boolean argument. Configures whether
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek to use multiple file descriptors (queues) to parallelize
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek packets sending and receiving. Defaults to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>no</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>PacketInfo=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Takes a boolean argument. Configures whether
ff9b60f38bf68eba4a47cabff14547d92e083214Torstein Husebø packets should be prepended with four extra bytes (two flag
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt bytes and two protocol bytes). If disabled, it indicates that
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the packets will be pure IP packets. Defaults to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>no</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani <varlistentry>
2aba142edd53865c0630ae2cddf9a45867a04277Lennart Poettering <term><varname>VNetHeader=</varname></term>
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani <listitem><para>Takes a boolean argument. Configures
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani IFF_VNET_HDR flag for a tap device. It allows sending
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani and receiving larger Generic Segmentation Offload (GSO)
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani packets. This may increase throughput significantly.
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani Defaults to
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani <literal>no</literal>.</para>
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani </listitem>
43f78da4ed39fb2ed5c85f8586b4f78409e31befSusant Sahani </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>User=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>User to grant access to the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/dev/net/tun</filename> device.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Group=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>Group to grant access to the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>/dev/net/tun</filename> device.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Tap] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[Tap]</literal> section only applies for
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek netdevs of kind <literal>tap</literal>, and accepts the same keys
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek as the <literal>[Tun]</literal> section.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Bond] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[Bond]</literal> section accepts the following
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek key:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Mode=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Specifies one of the bonding policies. The default is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>balance-rr</literal> (round robin). Possible values are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>balance-rr</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>active-backup</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>balance-xor</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>broadcast</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>802.3ad</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>balance-tlb</literal>, and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>balance-alb</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>TransmitHashPolicy=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Selects the transmit hash policy to use for slave
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek selection in balance-xor, 802.3ad, and tlb modes. Possible
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek values are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>layer2</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>layer3+4</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>layer2+3</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>encap2+3</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>802.3ad</literal>, and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>encap3+4</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>LACPTransmitRate=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Specifies the rate with which link partner transmits
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Link Aggregation Control Protocol Data Unit packets in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek 802.3ad mode. Possible values are <literal>slow</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek which requests partner to transmit LACPDUs every 30 seconds,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek and <literal>fast</literal>, which requests partner to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek transmit LACPDUs every second. The default value is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>slow</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MIIMonitorSec=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Specifies the frequency that Media Independent
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Interface link monitoring will occur. A value of zero
dd2b607b7d1ce355e93f9f71cd256ec20b8ae9c4Thomas Hindoe Paaboel Andersen disables MII link monitoring. This value is rounded down to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the nearest millisecond. The default value is 0.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>UpDelaySec=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Specifies the delay before a link is enabled after a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek link up status has been detected. This value is rounded down
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek to a multiple of MIIMonitorSec. The default value is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek 0.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>DownDelaySec=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Specifies the delay before a link is disabled after a
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek link down status has been detected. This value is rounded
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek down to a multiple of MIIMonitorSec. The default value is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek 0.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>LearnPacketIntervalSec=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the number of seconds between instances where the bonding
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt driver sends learning packets to each slave peer switch.
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt The valid range is 1–0x7fffffff; the default value is 1. This option
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt has an effect only for the balance-tlb and balance-alb modes.</para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <term><varname>AdSelect=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the 802.3ad aggregation selection logic to use. Possible values are
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <literal>stable</literal>,
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>bandwidth</literal> and
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>count</literal>.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>FailOverMACPolicy=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>Specifies whether the active-backup mode should set all slaves to
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt the same MAC address at the time of enslavement or, when enabled, to perform special handling of the
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani bond's MAC address in accordance with the selected policy. The default policy is none.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani Possible values are
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <literal>none</literal>,
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>active</literal> and
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>follow</literal>.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>ARPValidate=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies whether or not ARP probes and replies should be
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani validated in any mode that supports ARP monitoring, or whether
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani non-ARP traffic should be filtered (disregarded) for link
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani monitoring purposes. Possible values are
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <literal>none</literal>,
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <literal>active</literal>,
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>backup</literal> and
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>all</literal>.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>ARPIntervalSec=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the ARP link monitoring frequency in milliseconds.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani A value of 0 disables ARP monitoring. The default value is 0.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>ARPIPTargets=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the IP addresses to use as ARP monitoring peers when
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani ARPIntervalSec is greater than 0. These are the targets of the ARP request
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani sent to determine the health of the link to the targets.
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt Specify these values in IPv4 dotted decimal format. At least one IP
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani address must be given for ARP monitoring to function. The
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani maximum number of targets that can be specified is 16. The
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani default value is no IP addresses.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>ARPAllTargets=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <para>Specifies the quantity of ARPIPTargets that must be reachable
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani in order for the ARP monitor to consider a slave as being up.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani This option affects only active-backup mode for slaves with
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani ARPValidate enabled. Possible values are
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>any</literal> and
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>all</literal>.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>PrimaryReselectPolicy=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the reselection policy for the primary slave. This
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani affects how the primary slave is chosen to become the active slave
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani when failure of the active slave or recovery of the primary slave
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani occurs. This option is designed to prevent flip-flopping between
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani the primary slave and other slaves. Possible values are
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <literal>always</literal>,
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>better</literal> and
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>failure</literal>.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <term><varname>ResendIGMP=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the number of IGMP membership reports to be issued after
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani a failover event. One membership report is issued immediately after
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani the failover, subsequent packets are sent in each 200ms interval.
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt The valid range is 0–255. Defaults to 1. A value of 0
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani prevents the IGMP membership report from being issued in response
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani to the failover event.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <term><varname>PacketsPerSlave=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>Specify the number of packets to transmit through a slave before
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt moving to the next one. When set to 0, then a slave is chosen at
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt random. The valid range is 0–65535. Defaults to 1. This option
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt only has effect when in balance-rr mode.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani <term><varname>GratuitousARP=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specify the number of peer notifications (gratuitous ARPs and
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani unsolicited IPv6 Neighbor Advertisements) to be issued after a
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt failover event. As soon as the link is up on the new slave,
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani a peer notification is sent on the bonding device and each
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani VLAN sub-device. This is repeated at each link monitor interval
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani (ARPIntervalSec or MIIMonitorSec, whichever is active) if the number is
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt greater than 1. The valid range is 0–255. The default value is 1.
38422da754ddef86d4db46a5130dcfddb7487de2Susant Sahani These options affect only the active-backup mode.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <term><varname>AllSlavesActive=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <para>A boolean. Specifies that duplicate frames (received on inactive ports)
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt should be dropped when false, or delivered when true. Normally, bonding will drop
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani duplicate frames (received on inactive ports), which is desirable for
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani most users. But there are some times it is nice to allow duplicate
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani frames to be delivered. The default value is false (drop duplicate frames
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani received on inactive ports).
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <term><varname>MinLinks=</varname></term>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>Specifies the minimum number of links that must be active before
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani asserting carrier. The default value is 0.
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </listitem>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani </varlistentry>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </variablelist>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <para>For more detail information see
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani <ulink url="https://www.kernel.org/doc/Documentation/networking/bonding.txt">
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani Linux Ethernet Bonding Driver HOWTO</ulink></para>
81bd37a85fed090350a84db1f0741125582d160eSusant Sahani
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Example</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-bridge.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
eac684ef1c29684b1bcd27a89c38c202e568e469Tom GundersenName=bridge0
eac684ef1c29684b1bcd27a89c38c202e568e469Tom GundersenKind=bridge</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-vlan1.netdev</title>
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[Match]
eac684ef1c29684b1bcd27a89c38c202e568e469Tom GundersenVirtualization=no
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen[NetDev]
eac684ef1c29684b1bcd27a89c38c202e568e469Tom GundersenName=vlan1
eac684ef1c29684b1bcd27a89c38c202e568e469Tom GundersenKind=vlan
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen[VLAN]
eac684ef1c29684b1bcd27a89c38c202e568e469Tom GundersenId=1</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-ipip.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenName=ipip-tun
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenKind=ipip
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenMTUBytes=1480
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen[Tunnel]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenLocal=192.168.223.238
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenRemote=192.169.224.239
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenTTL=64</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-tap.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
30ae9dfda3788cdfaf1b84d124dbc7feb638c77bSusant SahaniName=tap-test
30ae9dfda3788cdfaf1b84d124dbc7feb638c77bSusant SahaniKind=tap
30ae9dfda3788cdfaf1b84d124dbc7feb638c77bSusant Sahani
30ae9dfda3788cdfaf1b84d124dbc7feb638c77bSusant Sahani[Tap]
30ae9dfda3788cdfaf1b84d124dbc7feb638c77bSusant SahaniMultiQueue=true
30ae9dfda3788cdfaf1b84d124dbc7feb638c77bSusant SahaniPacketInfo=true</programlisting> </example>
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-sit.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenName=sit-tun
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenKind=sit
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenMTUBytes=1480
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen[Tunnel]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenLocal=10.65.223.238
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenRemote=10.65.223.239</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-gre.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenName=gre-tun
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenKind=gre
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenMTUBytes=1480
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen[Tunnel]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenLocal=10.65.223.238
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenRemote=10.65.223.239</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-vti.netdev</title>
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenName=vti-tun
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenKind=vti
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenMTUBytes=1480
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen[Tunnel]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenLocal=10.65.223.238
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenRemote=10.65.223.239</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-veth.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenName=veth-test
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenKind=veth
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen[Peer]
b35a29096045f2b820d343bfa24a35eb033930a2Tom GundersenName=veth-peer</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
b35a29096045f2b820d343bfa24a35eb033930a2Tom Gundersen
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-bond.netdev</title>
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden <programlisting>[NetDev]
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major HaydenName=bond1
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major HaydenKind=bond
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden[Bond]
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major HaydenMode=802.3ad
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major HaydenTransmitHashPolicy=layer3+4
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major HaydenMIIMonitorSec=1s
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major HaydenLACPTransmitRate=fast
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden</programlisting>
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden </example>
d94facdcaa8053768a2d190ee8dd6ff5114f8b33Major Hayden
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <example>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-dummy.netdev</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[NetDev]
9e358851b470a1994287c8cb1d9eb78837faaf60Tom GundersenName=dummy-test
9e358851b470a1994287c8cb1d9eb78837faaf60Tom GundersenKind=dummy
9e358851b470a1994287c8cb1d9eb78837faaf60Tom GundersenMACAddress=12:34:56:78:9a:bc</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </example>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>See Also</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsect1>
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen
eac684ef1c29684b1bcd27a89c38c202e568e469Tom Gundersen</refentry>