man/systemd.netdev.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   This file is part of systemd.
   7
   8   Copyright 2013 Tom Gundersen
   9
  10   systemd is free software; you can redistribute it and/or modify it
  11   under the terms of the GNU Lesser General Public License as published by
  12   the Free Software Foundation; either version 2.1 of the License, or
  13   (at your option) any later version.
  14
  15   systemd is distributed in the hope that it will be useful, but
  16   WITHOUT ANY WARRANTY; without even the implied warranty of
  17   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  18   Lesser General Public License for more details.
  19
  20   You should have received a copy of the GNU Lesser General Public License
  21   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  22 -->
  23
  24 <refentry id="systemd.netdev" conditional='ENABLE_NETWORKD'>
  25
  26   <refentryinfo>
  27     <title>systemd.network</title>
  28     <productname>systemd</productname>
  29
  30     <authorgroup>
  31       <author>
  32         <contrib>Developer</contrib>
  33         <firstname>Tom</firstname>
  34         <surname>Gundersen</surname>
  35         <email>teg@jklm.no</email>
  36       </author>
  37     </authorgroup>
  38   </refentryinfo>
  39
  40   <refmeta>
  41     <refentrytitle>systemd.netdev</refentrytitle>
  42     <manvolnum>5</manvolnum>
  43   </refmeta>
  44
  45   <refnamediv>
  46     <refname>systemd.netdev</refname>
  47     <refpurpose>Virtual Network Device configuration</refpurpose>
  48   </refnamediv>
  49
  50   <refsynopsisdiv>
  51     <para><filename><replaceable>netdev</replaceable>.netdev</filename></para>
  52   </refsynopsisdiv>
  53
  54   <refsect1>
  55     <title>Description</title>
  56
  57     <para>Network setup is performed by
  58     <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
  59     </para>
  60
  61     <para>Virtual Network Device files must have the extension
  62     <filename>.netdev</filename>; other extensions are ignored.
  63     Virtual network devices are created as soon as networkd is
  64     started. If a netdev with the specified name already exists,
  65     networkd will use that as-is rather than create its own. Note that
  66     the settings of the pre-existing netdev will not be changed by
  67     networkd.</para>
  68
  69     <para>The <filename>.netdev</filename> files are read from the
  70     files located in the system network directory
  71     <filename>/usr/lib/systemd/network</filename>, the volatile
  72     runtime network directory
  73     <filename>/run/systemd/network</filename> and the local
  74     administration network directory
  75     <filename>/etc/systemd/network</filename>. All configuration files
  76     are collectively sorted and processed in lexical order, regardless
  77     of the directories in which they live. However, files with
  78     identical filenames replace each other. Files in
  79     <filename>/etc</filename> have the highest priority, files in
  80     <filename>/run</filename> take precedence over files with the same
  81     name in <filename>/usr/lib</filename>. This can be used to
  82     override a system-supplied configuration file with a local file if
  83     needed; a symlink in <filename>/etc</filename> with the same name
  84     as a configuration file in <filename>/usr/lib</filename>, pointing
  85     to <filename>/dev/null</filename>, disables the configuration file
  86     entirely.</para>
  87
  88   </refsect1>
  89
  90   <refsect1>
  91     <title>Supported netdev kinds</title>
  92
  93     <para>The following kinds of virtual network devices may be
  94     configured in <filename>.netdev</filename> files:</para>
  95
  96     <table>
  97       <title>Supported kinds of virtual network devices</title>
  98
  99       <tgroup cols='2'>
 100         <colspec colname='kind' />
 101         <colspec colname='explanation' />
 102         <thead><row>
 103           <entry>Kind</entry>
 104           <entry>Description</entry>
 105         </row></thead>
 106         <tbody>
 107           <row><entry><varname>bond</varname></entry>
 108           <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>
 109
 110           <row><entry><varname>bridge</varname></entry>
 111           <entry>A bridge devcie is a software switch, each of its slave devices and the bridge itself are ports of the switch.</entry></row>
 112
 113           <row><entry><varname>dummy</varname></entry>
 114           <entry>A dummy device drops all packets sent to it.</entry></row>
 115
 116           <row><entry><varname>gre</varname></entry>
 117           <entry>A Level 3 GRE tunnel over IPv4. See <ulink url="https://tools.ietf.org/html/rfc2784">RFC 2784</ulink> for details.</entry></row>
 118
 119           <row><entry><varname>gretap</varname></entry>
 120           <entry>A Level 2 GRE tunnel over IPv4.</entry></row>
 121
 122           <row><entry><varname>ip6gre</varname></entry>
 123           <entry>A Level 3 GRE tunnel over IPv6.</entry></row>
 124
 125           <row><entry><varname>ip6tnl</varname></entry>
 126           <entry>An IPv4 or IPv6 tunnel over IPv6</entry></row>
 127
 128           <row><entry><varname>ip6gretap</varname></entry>
 129           <entry>An Level 2 GRE tunnel over IPv6.</entry></row>
 130
 131           <row><entry><varname>ipip</varname></entry>
 132           <entry>An IPv4 over IPv4 tunnel.</entry></row>
 133
 134           <row><entry><varname>ipvlan</varname></entry>
 135           <entry>An ipvlan device is a stacked device which receives packets from its underlying device based on IP address filtering.</entry></row>
 136
 137           <row><entry><varname>macvlan</varname></entry>
 138           <entry>A macvlan device is a stacked device which receives packets from its underlying device based on MAC address filtering.</entry></row>
 139
 140           <row><entry><varname>sit</varname></entry>
 141           <entry>An IPv6 over IPv4 tunnel.</entry></row>
 142
 143           <row><entry><varname>tap</varname></entry>
 144           <entry>A persistent Level 2 tunnel between a network device and a device node.</entry></row>
 145
 146           <row><entry><varname>tun</varname></entry>
 147           <entry>A persistent Level 3 tunnel between a network device and a device node.</entry></row>
 148
 149           <row><entry><varname>veth</varname></entry>
 150           <entry>An ethernet tunnel between a pair of network devices.</entry></row>
 151
 152           <row><entry><varname>vlan</varname></entry>
 153           <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>
 154
 155           <row><entry><varname>vti</varname></entry>
 156           <entry>An IPv4 over IPSec tunnel.</entry></row>
 157
 158           <row><entry><varname>vxlan</varname></entry>
 159           <entry>A virtual extensible LAN (vxlan), for connecting Cloud computing deployments.</entry></row>
 160         </tbody>
 161       </tgroup>
 162     </table>
 163
 164   </refsect1>
 165
 166   <refsect1>
 167     <title>[Match] Section Options</title>
 168
 169     <para>A virtual network device is only created if the
 170     <literal>[Match]</literal> section matches the current
 171     environment, or if the section is empty. The following keys are
 172     accepted:</para>
 173
 174     <variablelist class='network-directives'>
 175       <varlistentry>
 176         <term><varname>Host=</varname></term>
 177         <listitem>
 178           <para>Matches against the hostname or machine ID of the
 179           host. See <literal>ConditionHost=</literal> in
 180           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 181           for details.
 182           </para>
 183         </listitem>
 184       </varlistentry>
 185       <varlistentry>
 186         <term><varname>Virtualization=</varname></term>
 187         <listitem>
 188           <para>Checks whether the system is executed in a virtualized
 189           environment and optionally test whether it is a specific
 190           implementation. See
 191           <literal>ConditionVirtualization=</literal> in
 192           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 193           for details.
 194           </para>
 195         </listitem>
 196       </varlistentry>
 197       <varlistentry>
 198         <term><varname>KernelCommandLine=</varname></term>
 199         <listitem>
 200           <para>Checks whether a specific kernel command line option
 201           is set (or if prefixed with the exclamation mark unset). See
 202           <literal>ConditionKernelCommandLine=</literal> in
 203           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 204           for details.
 205           </para>
 206         </listitem>
 207       </varlistentry>
 208       <varlistentry>
 209         <term><varname>Architecture=</varname></term>
 210         <listitem>
 211           <para>Checks whether the system is running on a specific
 212           architecture. See <literal>ConditionArchitecture=</literal> in
 213           <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 214           for details.
 215           </para>
 216         </listitem>
 217       </varlistentry>
 218     </variablelist>
 219
 220   </refsect1>
 221
 222   <refsect1>
 223     <title>[NetDev] Section Options</title>
 224
 225       <para>The <literal>[NetDev]</literal> section accepts the
 226       following keys:</para>
 227
 228       <variablelist class='network-directives'>
 229         <varlistentry>
 230           <term><varname>Description=</varname></term>
 231           <listitem>
 232             <para>A free-form description of the netdev.</para>
 233           </listitem>
 234         </varlistentry>
 235         <varlistentry>
 236           <term><varname>Name=</varname></term>
 237           <listitem>
 238             <para>The interface name used when creating the netdev.
 239             This option is compulsory.</para>
 240           </listitem>
 241         </varlistentry>
 242         <varlistentry>
 243           <term><varname>Kind=</varname></term>
 244           <listitem>
 245             <para>The netdev kind. This option is compulsory. See the
 246             <literal>Supported netdev kinds</literal> section for the
 247             valid keys.</para>
 248           </listitem>
 249         </varlistentry>
 250         <varlistentry>
 251           <term><varname>MTUBytes=</varname></term>
 252           <listitem>
 253             <para>The maximum transmission unit in bytes to set for
 254             the device. The usual suffixes K, M, G, are supported and
 255             are understood to the base of 1024. This key is not
 256             currently suported for <literal>tun</literal> or
 257             <literal>tap</literal> devices.
 258             </para>
 259           </listitem>
 260         </varlistentry>
 261         <varlistentry>
 262           <term><varname>MACAddress=</varname></term>
 263           <listitem>
 264             <para>The MAC address to use for the device. If none is
 265             given, one is generated based on the interface name and
 266             the
 267             <citerefentry><refentrytitle>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
 268             This key is not currently suported for
 269             <literal>tun</literal> or <literal>tap</literal> devices.
 270             </para>
 271           </listitem>
 272         </varlistentry>
 273       </variablelist>
 274   </refsect1>
 275
 276   <refsect1>
 277     <title>[VLAN] Section Options</title>
 278
 279       <para>The <literal>[VLAN]</literal> section only applies for
 280       netdevs of kind <literal>vlan</literal>, and accepts the
 281       following key:</para>
 282
 283       <variablelist class='network-directives'>
 284         <varlistentry>
 285           <term><varname>Id=</varname></term>
 286           <listitem>
 287             <para>The VLAN ID to use. An integer in the range 0–4094.
 288             This option is compulsory.</para>
 289           </listitem>
 290         </varlistentry>
 291       </variablelist>
 292
 293   </refsect1>
 294
 295   <refsect1>
 296     <title>[MACVLAN] Section Options</title>
 297
 298     <para>The <literal>[MACVLAN]</literal> section only applies for
 299     netdevs of kind <literal>macvlan</literal>, and accepts the
 300     following key:</para>
 301
 302     <variablelist class='network-directives'>
 303       <varlistentry>
 304         <term><varname>Mode=</varname></term>
 305         <listitem>
 306           <para>The MACVLAN mode to use. The supported options are
 307           <literal>private</literal>,
 308           <literal>vepa</literal>,
 309           <literal>bridge</literal>, and
 310           <literal>passthru</literal>.
 311           </para>
 312         </listitem>
 313       </varlistentry>
 314     </variablelist>
 315
 316   </refsect1>
 317
 318   <refsect1>
 319     <title>[IPVLAN] Section Options</title>
 320
 321     <para>The <literal>[IPVLAN]</literal> section only applies for
 322     netdevs of kind <literal>ipvlan</literal>, and accepts the
 323     following key:</para>
 324
 325     <variablelist class='network-directives'>
 326       <varlistentry>
 327         <term><varname>Mode=</varname></term>
 328           <listitem>
 329             <para>The IPVLAN mode to use. The supported options are
 330             <literal>L2</literal> and <literal>L3</literal>.
 331             </para>
 332           </listitem>
 333       </varlistentry>
 334     </variablelist>
 335
 336   </refsect1>
 337
 338   <refsect1>
 339     <title>[VXLAN] Section Options</title>
 340     <para>The <literal>[VXLAN]</literal> section only applies for
 341     netdevs of kind <literal>vxlan</literal>, and accepts the
 342     following keys:</para>
 343
 344     <variablelist class='network-directives'>
 345       <varlistentry>
 346         <term><varname>Id=</varname></term>
 347         <listitem>
 348           <para>The VXLAN ID to use.</para>
 349         </listitem>
 350       </varlistentry>
 351       <varlistentry>
 352         <term><varname>Group=</varname></term>
 353         <listitem>
 354           <para>An assigned multicast group IP address.</para>
 355         </listitem>
 356       </varlistentry>
 357       <varlistentry>
 358         <term><varname>TOS=</varname></term>
 359         <listitem>
 360           <para>The Type Of Service byte value for a vxlan interface.</para>
 361         </listitem>
 362       </varlistentry>
 363       <varlistentry>
 364         <term><varname>TTL=</varname></term>
 365         <listitem>
 366           <para>A fixed Time To Live N on Virtual eXtensible Local
 367           Area Network packets. N is a number in the range 1-255. 0
 368           is a special value meaning that packets inherit the TTL
 369           value.</para>
 370         </listitem>
 371       </varlistentry>
 372       <varlistentry>
 373         <term><varname>MacLearning=</varname></term>
 374         <listitem>
 375           <para>A boolean. When true, enables dynamic MAC learning
 376           to discover remote MAC addresses.</para>
 377         </listitem>
 378       </varlistentry>
 379       <varlistentry>
 380         <term><varname>FDBAgeingSec=</varname></term>
 381         <listitem>
 382           <para>The lifetime of Forwarding Database entry learnt by
 383           the kernel in seconds.</para>
 384         </listitem>
 385       </varlistentry>
 386       <varlistentry>
 387         <term><varname>ARPProxy=</varname></term>
 388         <listitem>
 389           <para>A boolean. When true, enables ARP proxy.</para>
 390         </listitem>
 391       </varlistentry>
 392       <varlistentry>
 393         <term><varname>L2MissNotification=</varname></term>
 394         <listitem>
 395           <para>A boolean. When true, enables netlink LLADDR miss
 396           notifications.</para>
 397         </listitem>
 398       </varlistentry>
 399       <varlistentry>
 400         <term><varname>L3MissNotification=</varname></term>
 401         <listitem>
 402           <para>A boolean. When true, enables netlink IP ADDR miss
 403           notifications.</para>
 404         </listitem>
 405       </varlistentry>
 406       <varlistentry>
 407         <term><varname>RouteShortCircuit=</varname></term>
 408         <listitem>
 409           <para>A boolean. When true route short circuit is turned
 410           on.</para>
 411         </listitem>
 412       </varlistentry>
 413     </variablelist>
 414   </refsect1>
 415   <refsect1>
 416     <title>[Tunnel] Section Options</title>
 417
 418     <para>The <literal>[Tunnel]</literal> section only applies for
 419     netdevs of kind
 420     <literal>ipip</literal>,
 421     <literal>sit</literal>,
 422     <literal>gre</literal>,
 423     <literal>gretap</literal>,
 424     <literal>ip6gre</literal>,
 425     <literal>ip6gretap</literal>,
 426     <literal>vti</literal>, and
 427     <literal>ip6tnl</literal> and accepts
 428     the following keys:</para>
 429
 430     <variablelist class='network-directives'>
 431       <varlistentry>
 432         <term><varname>Local=</varname></term>
 433         <listitem>
 434           <para>A static local address for tunneled packets. It must
 435           be an address on another interface of this host.</para>
 436         </listitem>
 437       </varlistentry>
 438       <varlistentry>
 439         <term><varname>Remote=</varname></term>
 440         <listitem>
 441           <para>The remote endpoint of the tunnel.</para>
 442         </listitem>
 443       </varlistentry>
 444       <varlistentry>
 445         <term><varname>TOS=</varname></term>
 446         <listitem>
 447           <para>The Type Of Service byte value for a tunnel interface.
 448           For details about the TOS see the
 449           <ulink url="http://tools.ietf.org/html/rfc1349"> Type of
 450           Service in the Internet Protocol Suite </ulink> document.
 451           </para>
 452         </listitem>
 453       </varlistentry>
 454       <varlistentry>
 455         <term><varname>TTL=</varname></term>
 456         <listitem>
 457           <para>A fixed Time To Live N on tunneled packets. N is a
 458           number in the range 1-255. 0 is a special value meaning that
 459           packets inherit the TTL value. The default value for IPv4
 460           tunnels is: inherit. The default value for IPv6 tunnels is:
 461           64.</para>
 462         </listitem>
 463       </varlistentry>
 464       <varlistentry>
 465         <term><varname>DiscoverPathMTU=</varname></term>
 466         <listitem>
 467           <para>A boolean. When true, enables Path MTU Discovery on
 468           the tunnel.</para>
 469         </listitem>
 470       </varlistentry>
 471       <varlistentry>
 472         <term><varname>Mode=</varname></term>
 473         <listitem>
 474           <para>An <literal>ip6tnl</literal> tunnels can have three
 475           modes
 476           <literal>ip6ip6</literal> for IPv6 over IPv6,
 477           <literal>ipip6</literal> for IPv4 over IPv6 or
 478           <literal>any</literal> for either.
 479           </para>
 480         </listitem>
 481       </varlistentry>
 482     </variablelist>
 483   </refsect1>
 484   <refsect1>
 485     <title>[Peer] Section Options</title>
 486
 487       <para>The <literal>[Peer]</literal> section only applies for
 488       netdevs of kind <literal>veth</literal> and accepts the
 489       following key:</para>
 490
 491       <variablelist class='network-directives'>
 492         <varlistentry>
 493           <term><varname>Name=</varname></term>
 494           <listitem>
 495             <para>The interface name used when creating the netdev.
 496             This option is compulsory.</para>
 497           </listitem>
 498         </varlistentry>
 499         <varlistentry>
 500           <term><varname>MACAddress=</varname></term>
 501           <listitem>
 502             <para>The peer MACAddress, if not set it is generated in
 503             the same way as the MAC address of the main
 504             interface.</para>
 505           </listitem>
 506         </varlistentry>
 507       </variablelist>
 508   </refsect1>
 509   <refsect1>
 510     <title>[Tun] Section Options</title>
 511
 512     <para>The <literal>[Tun]</literal> section only applies for
 513     netdevs of kind <literal>tun</literal>, and accepts the following
 514     keys:</para>
 515
 516     <variablelist class='network-directives'>
 517       <varlistentry>
 518         <term><varname>OneQueue=</varname></term>
 519         <listitem><para>Takes a boolean argument. Configures whether
 520         all packets are queued at the device (enabled), or a fixed
 521         number of packets are queued at the device and the rest at the
 522         <literal>qdisc</literal>. Defaults to
 523         <literal>no</literal>.</para>
 524         </listitem>
 525       </varlistentry>
 526       <varlistentry>
 527         <term><varname>MultiQueue=</varname></term>
 528         <listitem><para>Takes a boolean argument. Configures whether
 529         to use multiple file descriptors (queues) to parallelize
 530         packets sending and receiving. Defaults to
 531         <literal>no</literal>.</para>
 532         </listitem>
 533       </varlistentry>
 534       <varlistentry>
 535         <term><varname>PacketInfo=</varname></term>
 536         <listitem><para>Takes a boolean argument. Configures whether
 537         packets should be prepened with four extra bytes (two flag
 538         bytes and two protocol bytes). If disabled it indicates that
 539         the packets will be pure IP packets. Defaults to
 540         <literal>no</literal>.</para>
 541         </listitem>
 542       </varlistentry>
 543       <varlistentry>
 544         <term><varname>User=</varname></term>
 545         <listitem><para>User to grant access to the
 546         <filename>/dev/net/tun</filename> device.</para>
 547         </listitem>
 548       </varlistentry>
 549       <varlistentry>
 550         <term><varname>Group=</varname></term>
 551         <listitem><para>Group to grant access to the
 552         <filename>/dev/net/tun</filename> device.</para>
 553         </listitem>
 554       </varlistentry>
 555
 556     </variablelist>
 557
 558   </refsect1>
 559
 560   <refsect1>
 561     <title>[Tap] Section Options</title>
 562
 563     <para>The <literal>[Tap]</literal> section only applies for
 564     netdevs of kind <literal>tap</literal>, and accepts the same keys
 565     as the <literal>[Tun]</literal> section.</para>
 566   </refsect1>
 567
 568   <refsect1>
 569     <title>[Bond] Section Options</title>
 570
 571     <para>The <literal>[Bond]</literal> section accepts the following
 572     key:</para>
 573
 574     <variablelist class='network-directives'>
 575       <varlistentry>
 576         <term><varname>Mode=</varname></term>
 577         <listitem>
 578           <para>Specifies one of the bonding policies. The default is
 579           <literal>balance-rr</literal> (round robin). Possible values are
 580           <literal>balance-rr</literal>,
 581           <literal>active-backup</literal>,
 582           <literal>balance-xor</literal>,
 583           <literal>broadcast</literal>,
 584           <literal>802.3ad</literal>,
 585           <literal>balance-tlb</literal>, and
 586           <literal>balance-alb</literal>.
 587           </para>
 588         </listitem>
 589       </varlistentry>
 590
 591       <varlistentry>
 592         <term><varname>TransmitHashPolicy=</varname></term>
 593         <listitem>
 594           <para>Selects the transmit hash policy to use for slave
 595           selection in balance-xor, 802.3ad, and tlb modes. Possible
 596           values are
 597           <literal>layer2</literal>,
 598           <literal>layer3+4</literal>,
 599           <literal>layer2+3</literal>,
 600           <literal>encap2+3</literal>,
 601           <literal>802.3ad</literal>, and
 602           <literal>encap3+4</literal>.
 603           </para>
 604         </listitem>
 605       </varlistentry>
 606
 607       <varlistentry>
 608         <term><varname>LACPTransmitRate=</varname></term>
 609         <listitem>
 610           <para>Specifies the rate with which link partner transmits
 611           Link Aggregation Control Protocol Data Unit packets in
 612           802.3ad mode. Possible values are <literal>slow</literal>,
 613           which requests partner to transmit LACPDUs every 30 seconds,
 614           and <literal>fast</literal>, which requests partner to
 615           transmit LACPDUs every second. The default value is
 616           <literal>slow</literal>.</para>
 617         </listitem>
 618       </varlistentry>
 619
 620       <varlistentry>
 621         <term><varname>MIIMonitorSec=</varname></term>
 622         <listitem>
 623           <para>Specifies the frequency that Media Independent
 624           Interface link monitoring will occur. A value of zero
 625           disables MII link monitoring. This values is rounded down to
 626           the nearest millisecond. The default value is 0.</para>
 627         </listitem>
 628       </varlistentry>
 629
 630       <varlistentry>
 631         <term><varname>UpDelaySec=</varname></term>
 632         <listitem>
 633           <para>Specifies the delay before a link is enabled after a
 634           link up status has been detected. This value is rounded down
 635           to a multiple of MIIMonitorSec. The default value is
 636           0.</para>
 637         </listitem>
 638       </varlistentry>
 639
 640       <varlistentry>
 641         <term><varname>DownDelaySec=</varname></term>
 642         <listitem>
 643           <para>Specifies the delay before a link is disabled after a
 644           link down status has been detected. This value is rounded
 645           down to a multiple of MIIMonitorSec. The default value is
 646           0.</para>
 647         </listitem>
 648       </varlistentry>
 649
 650     </variablelist>
 651   </refsect1>
 652
 653   <refsect1>
 654     <title>Example</title>
 655     <example>
 656       <title>/etc/systemd/network/bridge.netdev</title>
 657
 658       <programlisting>[NetDev]
 659 Name=bridge0
 660 Kind=bridge</programlisting>
 661     </example>
 662
 663     <example>
 664       <title>/etc/systemd/network/vlan1.netdev</title>
 665
 666       <programlisting>[Match]
 667 Virtualization=no
 668
 669 [NetDev]
 670 Name=vlan1
 671 Kind=vlan
 672
 673 [VLAN]
 674 Id=1</programlisting>
 675     </example>
 676     <example>
 677       <title>/etc/systemd/network/ipip.netdev</title>
 678       <programlisting>[NetDev]
 679 Name=ipip-tun
 680 Kind=ipip
 681 MTUBytes=1480
 682
 683 [Tunnel]
 684 Local=192.168.223.238
 685 Remote=192.169.224.239
 686 TTL=64</programlisting>
 687     </example>
 688     <example>
 689       <title>/etc/systemd/network/tap.netdev</title>
 690       <programlisting>[NetDev]
 691 Name=tap-test
 692 Kind=tap
 693
 694 [Tap]
 695 MultiQueue=true
 696 PacketInfo=true</programlisting> </example>
 697
 698     <example>
 699       <title>/etc/systemd/network/sit.netdev</title>
 700       <programlisting>[NetDev]
 701 Name=sit-tun
 702 Kind=sit
 703 MTUBytes=1480
 704
 705 [Tunnel]
 706 Local=10.65.223.238
 707 Remote=10.65.223.239</programlisting>
 708     </example>
 709
 710     <example>
 711       <title>/etc/systemd/network/gre.netdev</title>
 712       <programlisting>[NetDev]
 713 Name=gre-tun
 714 Kind=gre
 715 MTUBytes=1480
 716
 717 [Tunnel]
 718 Local=10.65.223.238
 719 Remote=10.65.223.239</programlisting>
 720     </example>
 721
 722     <example>
 723       <title>/etc/systemd/network/vti.netdev</title>
 724
 725       <programlisting>[NetDev]
 726 Name=vti-tun
 727 Kind=vti
 728 MTUBytes=1480
 729
 730 [Tunnel]
 731 Local=10.65.223.238
 732 Remote=10.65.223.239</programlisting>
 733     </example>
 734
 735     <example>
 736       <title>/etc/systemd/network/veth.netdev</title>
 737       <programlisting>[NetDev]
 738 Name=veth-test
 739 Kind=veth
 740
 741 [Peer]
 742 Name=veth-peer</programlisting>
 743     </example>
 744
 745     <example>
 746       <title>/etc/systemd/network/dummy.netdev</title>
 747       <programlisting>[NetDev]
 748 Name=dummy-test
 749 Kind=dummy
 750 MACAddress=12:34:56:78:9a:bc</programlisting>
 751     </example>
 752
 753   </refsect1>
 754   <refsect1>
 755     <title>See Also</title>
 756     <para>
 757       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
 758       <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
 759       <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
 760       <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
 761     </para>
 762   </refsect1>
 763
 764 </refentry>