b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering<?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen This file is part of systemd.
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen Copyright 2014 Tom Gundersen
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen systemd is free software; you can redistribute it and/or modify it
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen under the terms of the GNU Lesser General Public License as published by
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen the Free Software Foundation; either version 2.1 of the License, or
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen (at your option) any later version.
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen systemd is distributed in the hope that it will be useful, but
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen WITHOUT ANY WARRANTY; without even the implied warranty of
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen Lesser General Public License for more details.
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen You should have received a copy of the GNU Lesser General Public License
1ff28eaee33d9d0cee46bd176b6d6f8805c95036Tom Gundersen along with systemd; If not, see <http://www.gnu.org/licenses/>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd.link</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Network device configuration</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename><replaceable>link</replaceable>.link</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Network link configuration is performed by the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <command>net_setup_link</command> udev builtin.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The link files are read from the files located in the system
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen network directory <filename>/usr/lib/systemd/network</filename>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the volatile 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>. Link files must have
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the extension <filename>.link</filename>; other extensions are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek ignored. All link files are collectively sorted and processed in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek lexical order, regardless of the directories in which they live.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek However, files with identical filenames replace each other. Files
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek in <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
57e27ec0ada6775d85a5201cd25e989d92d0a1afZbigniew Jędrzejewski-Szmek override a system-supplied link file with a local file if needed.
57e27ec0ada6775d85a5201cd25e989d92d0a1afZbigniew Jędrzejewski-Szmek As a special case, an empty file (file size 0) or symlink with the
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt same name pointing to <filename>/dev/null</filename> disables the
57e27ec0ada6775d85a5201cd25e989d92d0a1afZbigniew Jędrzejewski-Szmek configuration file entirely (it is "masked").</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The link file contains a <literal>[Match]</literal> section,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek which determines if a given link file may be applied to a given
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek device, as well as a <literal>[Link]</literal> section specifying
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek how the device should be configured. The first (in lexical order)
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek of the link files that matches a given device is applied. Note
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek that a default file <filename>99-default.link</filename> is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek shipped by the system, any user-supplied
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>.link</filename> should hence have a lexically earlier
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek name to be considered at all.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Match] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A link file is said to match a device if each of the entries
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek in the <literal>[Match]</literal> section matches, or if the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek section is empty. The following keys are accepted:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MACAddress=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The hardware address.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>OriginalName=</varname></term>
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen <para>A whitespace-separated list of shell-style globs matching
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen the device name, as exposed by the udev property
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen "INTERFACE". This can not be used to match on names that have
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen already been changed from userspace. Caution is advised when matching on
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek kernel-assigned names, as they are known to be unstable
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek between reboots.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Path=</varname></term>
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen <para>A whitespace-separated list of shell-style globs matching
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen the persistent path, as exposed by the udev property
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Driver=</varname></term>
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen <para>A whitespace-separated list of shell-style globs matching
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen the driver currently bound to the device,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek as exposed by the udev property <literal>DRIVER</literal>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek of its parent device, or if that is not set, the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek driver as exposed by <literal>ethtool -i</literal>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek of the device itself.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Type=</varname></term>
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen <para>A whitespace-separated list of shell-style globs matching
5256e00e8b9015dd1a976d647fc71dc7efbd8cf8Tom Gundersen the device type, as exposed by the udev
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek property <literal>DEVTYPE</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Host=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Matches against the hostname or machine
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek ID of the 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.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Virtualization=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Checks whether the system is executed in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek a virtualized environment and optionally test
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek whether it is a specific 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.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>KernelCommandLine=</varname></term>
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.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Architecture=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Checks whether the system is running on a specific
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek architecture. See <literal>ConditionArchitecture=</literal>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>[Link] Section Options</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>[Link]</literal> section accepts the following
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <variablelist class='network-directives'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Description=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A description of the device.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Alias=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The <literal>ifalias</literal> is set to this
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MACAddressPolicy=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The policy by which the MAC address should be set. The
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek available policies are:
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>persistent</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>If the hardware has a persistent MAC address, as
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek most hardware should, and if it is used by the kernel,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek nothing is done. Otherwise, a new MAC address is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek generated which is guaranteed to be the same on every
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek boot for the given machine and the given device, but
1c25683e0f40c6169676cc44fa1897082597feecTom Gundersen which is otherwise random. This feature depends on ID_NET_NAME_*
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt properties to exist for the link. On hardware where these
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt properties are not set, the generation of a persistent MAC address
1c25683e0f40c6169676cc44fa1897082597feecTom Gundersen will fail.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>random</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>If the kernel is using a random MAC address,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek nothing is done. Otherwise, a new address is randomly
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek generated each time the device appears, typically at
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt boot. Either way, the random address will have the
2e229e0c4c29e8a827be9ffe361741cf5e9aa7afTom Gundersen <literal>locally administered</literal> bits set.</para>
66d3752e812915a549ebee01769ee761c1495667Jacob Keller <varlistentry>
66d3752e812915a549ebee01769ee761c1495667Jacob Keller <para>Keeps the MAC address assigned by the kernel.</para>
66d3752e812915a549ebee01769ee761c1495667Jacob Keller </varlistentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MACAddress=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The MAC address to use, if no
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>MACAddressPolicy=</literal>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek is specified.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>NamePolicy=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>An ordered, space-separated list of policies by which
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the interface name should be set.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>NamePolicy</literal> may be disabled by specifying
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>net.ifnames=0</literal> on the kernel command line.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Each of the policies may fail, and the first successful one
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek is used. The name is not set directly, but is exported to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek udev as the property <literal>ID_NET_NAME</literal>, which
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek is, by default, used by a udev rule to set
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>NAME</literal>. If the name has already been set by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek userspace, no renaming is performed. The available policies
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>kernel</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>If the kernel claims that the name it has set
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for a device is predictable, then no renaming is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek performed.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>database</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The name is set based on entries in the udev's
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Hardware Database with the key
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ID_NET_NAME_FROM_DATABASE</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>onboard</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The name is set based on information given by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the firmware for on-board devices, as exported by the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek udev property <literal>ID_NET_NAME_ONBOARD</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>slot</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The name is set based on information given by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the firmware for hot-plug devices, as exported by the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek udev property <literal>ID_NET_NAME_SLOT</literal>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>path</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The name is set based on the device's physical
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek location, as exported by the udev property
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ID_NET_NAME_PATH</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>mac</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The name is set based on the device's persistent
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek MAC address, as exported by the udev property
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ID_NET_NAME_MAC</literal>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Name=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The interface name to use in case all the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek policies specified in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varname>NamePolicy=</varname> fail, or in case
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <varname>NamePolicy=</varname> is missing or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek disabled.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>MTUBytes=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The maximum transmission unit in bytes to set for the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek device. The usual suffixes K, M, G, are supported and are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek understood to the base of 1024.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>BitsPerSecond=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The speed to set for the device, the value is rounded
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek down to the nearest Mbps. The usual suffixes K, M, G, are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek supported and are understood to the base of 1000.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>Duplex=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The duplex mode to set for the device. The accepted
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek values are <literal>half</literal> and
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><varname>WakeOnLan=</varname></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The Wake-on-LAN policy to set for the device. The
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek supported values are:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>phy</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Wake on PHY activity.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>magic</literal></term>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Wake on receipt of a magic packet.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <term><literal>off</literal></term>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <title>/usr/lib/systemd/network/99-default.link</title>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <para>The link file <filename>99-default.link</filename> that is
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering shipped with systemd defines the default naming policy for
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <programlisting>[Link]
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart PoetteringNamePolicy=kernel database onboard slot path
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart PoetteringMACAddressPolicy=persistent</programlisting>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <title>/etc/systemd/network/10-dmz.link</title>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <para>This example assigns the fixed name
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <literal>dmz0</literal> to the interface with the MAC address
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering 00:a0:de:63:7a:e6:</para>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <programlisting>[Match]
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart PoetteringMACAddress=00:a0:de:63:7a:e6
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart PoetteringName=dmz0</programlisting>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <title>/etc/systemd/network/10-internet.link</title>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <para>This example assigns the fixed name
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <literal>internet0</literal> to the interface with the device
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering path <literal>pci-0000:00:1a.0-*</literal>:</para>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <programlisting>[Match]
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart PoetteringPath=pci-0000:00:1a.0-*
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart PoetteringName=internet0</programlisting>
6c1695be47b2830c79e128e4d05d760eb862184eLennart Poettering <title>/etc/systemd/network/25-wireless.link</title>
b97e7fabaeaf12c88d6a10b2bfead54a77812105Lennart Poettering <para>Here's an overly complex example that shows the use of a large number of [Match] and [Link] settings.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>[Match]
7abaad1ab099b077ebd6452b14ef351483831245pomaMACAddress=12:34:56:78:9a:bc
7abaad1ab099b077ebd6452b14ef351483831245pomaDriver=brcmsmac
7abaad1ab099b077ebd6452b14ef351483831245pomaPath=pci-0000:02:00.0-*
7abaad1ab099b077ebd6452b14ef351483831245pomaVirtualization=no
7abaad1ab099b077ebd6452b14ef351483831245pomaHost=my-laptop
7abaad1ab099b077ebd6452b14ef351483831245pomaArchitecture=x86-64
7abaad1ab099b077ebd6452b14ef351483831245pomaName=wireless0
7abaad1ab099b077ebd6452b14ef351483831245pomaMTUBytes=1450
7abaad1ab099b077ebd6452b14ef351483831245pomaBitsPerSecond=10M
7abaad1ab099b077ebd6452b14ef351483831245pomaWakeOnLan=magic
7abaad1ab099b077ebd6452b14ef351483831245pomaMACAddress=cb:a9:87:65:43:21</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd-udevd.service</refentrytitle><manvolnum>8</manvolnum>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>udevadm</refentrytitle><manvolnum>8</manvolnum>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum>