systemd.netdev.xml   systemd.netdev.xml 
skipping to change at line 63 skipping to change at line 63
<refsect1> <refsect1>
<title>Description</title> <title>Description</title>
<para>Network setup is performed by <para>Network setup is performed by
<citerefentry><refentrytitle>systemd-networkd</refentrytitl e><manvolnum>8</manvolnum></citerefentry>. <citerefentry><refentrytitle>systemd-networkd</refentrytitl e><manvolnum>8</manvolnum></citerefentry>.
</para> </para>
<para>Virtual Network Device files must have the extension <para>Virtual Network Device files must have the extension
<filename>.netdev</filename>; other extensions are ignored. Virtual <filename>.netdev</filename>; other extensions are ignored. Virtual
network devices are created as soon as networkd is started. network devices are created as soon as networkd is started.
</para> If a netdev
with the specified name already exists, networkd will use t
hat as-is
rather than create its own. Note that the settings of the p
re-existing
netdev will not be changed by networkd.</para>
<para>The <filename>.netdev</filename> files are read from the files located in the <para>The <filename>.netdev</filename> files are read from the files located in the
system network directory <filename>/usr/lib/systemd/network </filename>, system network directory <filename>/usr/lib/systemd/network </filename>,
the volatile runtime network directory the volatile runtime network directory
<filename>/run/systemd/network</filename> and the local adm inistration <filename>/run/systemd/network</filename> and the local adm inistration
network directory <filename>/etc/systemd/network</filename> . network directory <filename>/etc/systemd/network</filename> .
All configuration files are collectively sorted and process ed in lexical order, All configuration files are collectively sorted and process ed in lexical order,
regardless of the directories in which they live. However, files with regardless of the directories in which they live. However, files with
identical filenames replace each other. Files in identical filenames replace each other. Files in
<filename>/etc</filename> have the highest priority, files in <filename>/etc</filename> have the highest priority, files in
skipping to change at line 166 skipping to change at line 169
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>Kind=</varname></ter m> <term><varname>Kind=</varname></ter m>
<listitem> <listitem>
<para>The netdev kind. Curr ently, <literal>bridge</literal>, <para>The netdev kind. Curr ently, <literal>bridge</literal>,
<literal>bond</literal>, <l iteral>vlan</literal>, <literal>bond</literal>, <l iteral>vlan</literal>,
<literal>macvlan</literal>, <literal>vxlan</literal>, <literal>macvlan</literal>, <literal>vxlan</literal>,
<literal>ipip</literal>, <l iteral>gre</literal>, <literal>ipip</literal>, <l iteral>gre</literal>,
<literal>sit</literal>, <li teral>vti</literal>, <literal>sit</literal>, <li teral>vti</literal>,
<literal>veth</literal>, an <literal>veth</literal>, <l
d <literal>dummy</literal> iteral>tun</literal>,
<literal>tap</literal> and
<literal>dummy</literal>
are supported. This option is compulsory.</para> are supported. This option is compulsory.</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>MTUBytes=</varname>< /term> <term><varname>MTUBytes=</varname>< /term>
<listitem> <listitem>
<para>The maximum transmiss ion unit in bytes to <para>The maximum transmiss ion unit in bytes to
set for the device. The usu al suffixes K, M, G, set for the device. The usu al suffixes K, M, G,
are supported and are under stood to the base of are supported and are under stood to the base of
1024.</para> 1024. This key is not curre
ntly suported for
<literal>tun</literal> or <
literal>tap</literal> devices.
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><varname>MACAddress=</varname ></term> <term><varname>MACAddress=</varname ></term>
<listitem> <listitem>
<para>The MAC address to us e for the device. <para>The MAC address to us e for the device.
If none is given, one is ge nerated based on If none is given, one is ge nerated based on
the interface name and the the interface name and the
<citerefentry><refentrytitl e>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>. <citerefentry><refentrytitl e>machine-id</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
This key is not currently s uported for <literal>tun</literal> or <literal>tap</literal> devices.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>[VLAN] Section Options</title> <title>[VLAN] Section Options</title>
<para>The <literal>[VLAN]</literal> section only ap plies for netdevs of kind <literal>vlan</literal>, <para>The <literal>[VLAN]</literal> section only ap plies for netdevs of kind <literal>vlan</literal>,
skipping to change at line 398 skipping to change at line 405
<refsect1> <refsect1>
<title>[Tap] Section Options</title> <title>[Tap] Section Options</title>
<para>The <literal>[Tap]</literal> section only app lies for netdevs of kind <para>The <literal>[Tap]</literal> section only app lies for netdevs of kind
<literal>tap</literal>, and accepts the same keys a s the <literal>tap</literal>, and accepts the same keys a s the
<literal>[Tun]</literal> section.</para> <literal>[Tun]</literal> section.</para>
</refsect1> </refsect1>
<refsect1> <refsect1>
<title>[Bond] Section Options</title>
<para>The <literal>[Bond]</literal> section accepts
the following
key:</para>
<variablelist class='network-directives'>
<varlistentry>
<term><varname>Mode=</varname></ter
m>
<listitem>
<para>Specifies one of the bondin
g policies. The default is
<literal>balance-rr</literal> (ro
und robin). Possible values are
<literal>balance-rr</litera
l>,
<literal>active-backup</lit
eral>,
<literal>balance-xor</liter
al>,
<literal>broadcast</literal
>,
<literal>802.3ad</literal>,
<literal>balance-tlb</liter
al>, and
<literal>balance-alb</liter
al>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>TransmitHashPolicy=</varna
me></term>
<listitem>
<para>Selects the transmit hash policy
to use for slave selection in
balance-xor, 802.3ad, and tlb modes. Po
ssible values are
<literal>layer2</literal>,
<literal>layer3+4</literal>,
<literal>layer2+3</literal>,
<literal>encap2+3</literal>,
<literal>802.3ad</literal>, and
<literal>encap3+4</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>LACPTransmitRate=</varname
></term>
<listitem>
<para>Specifies the rate with which lin
k partner
transmits Link Aggregation Control Prot
ocol Data Unit packets
in 802.3ad mode. Possible values are
<literal>slow</literal>, which requests
partner to transmit LACPDUs every 30 seconds, and
<literal>fast</literal>, which requests
partner to transmit LACPDUs every second.
The default value is <literal>slow</lit
eral>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>MIIMonitorSec=</varname></
term>
<listitem>
<para>Specifies the frequency that Medi
a Independent Interface link
monitoring will occur. A value of zero
disables MII link monitoring.
This values is rounded down to the near
est millisecond. The default
value is 0.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>UpDelaySec=</varname></ter
m>
<listitem>
<para>Specifies the delay before a link
is enabled after a link up
status has been detected. This value is
rounded down to a multiple of
MIIMonitorSec. The default value is 0.<
/para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>DownDelaySec=</varname></t
erm>
<listitem>
<para>Specifies the delay before a link
is disabled after a link down
status has been detected. This value is
rounded down to a multiple of
MIIMonitorSec. The default value is 0.<
/para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Example</title> <title>Example</title>
<example> <example>
<title>/etc/systemd/network/bridge.netdev</title> <title>/etc/systemd/network/bridge.netdev</title>
<programlisting>[NetDev] <programlisting>[NetDev]
Name=bridge0 Name=bridge0
Kind=bridge</programlisting> Kind=bridge</programlisting>
</example> </example>
<example> <example>
 End of changes. 5 change blocks. 
5 lines changed or deleted 129 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/