systemd.network.xml revision 0566ef68b816f094c3bc1c6c3921c8c35bc6d87f
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames This file is part of systemd.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames Copyright 2013 Tom Gundersen
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames systemd is free software; you can redistribute it and/or modify it
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames under the terms of the GNU Lesser General Public License as published by
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames the Free Software Foundation; either version 2.1 of the License, or
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames (at your option) any later version.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames systemd is distributed in the hope that it will be useful, but
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames WITHOUT ANY WARRANTY; without even the implied warranty of
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames Lesser General Public License for more details.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames You should have received a copy of the GNU Lesser General Public License
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames along with systemd; If not, see <http://www.gnu.org/licenses/>.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames<refentry id="systemd.network" conditional='ENABLE_NETWORKD'>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <refentryinfo>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <authorgroup>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </authorgroup>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </refentryinfo>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <refnamediv>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </refnamediv>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <refsynopsisdiv>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para><filename><replaceable>network</replaceable>.network</filename></para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </refsynopsisdiv>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>Network setup is performed by
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <citerefentry><refentrytitle>systemd-networkd</refentrytitle><manvolnum>8</manvolnum></citerefentry>.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>Network files must have the extension <filename>.network</filename>;
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames other extensions are ignored. Networks are applied to links whenever the links
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames appear.</para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>The <filename>.network</filename> files are read from the files located in the
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames system network directory <filename>/usr/lib/systemd/network</filename>,
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames the volatile runtime network directory
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <filename>/run/systemd/network</filename> and the local administration
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames network directory <filename>/etc/systemd/network</filename>.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames All configuration files are collectively sorted and processed in lexical order,
43162230430f8144afe9c32cd0e60b927f4e0a60gregames regardless of the directories in which they live. However, files with
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames identical filenames replace each other. Files in
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <filename>/etc</filename> have the highest priority, files in
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <filename>/run</filename> take precedence over files with the same
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames name in <filename>/usr/lib</filename>. This can be used to override a
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames system-supplied configuration file with a local file if needed; a symlink in
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <filename>/etc</filename> with the same name as a configuration file in
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <filename>/usr/lib</filename>, pointing to <filename>/dev/null</filename>,
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames disables the configuration file entirely.</para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </refsect1>
c0d403aebd449af101969d1ff60a8cbcf9ecf35cgregames <para>The network file contains a <literal>[Match]</literal> section,
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames which determines if a given network file may be applied to a given device;
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames and a <literal>[Network]</literal> section specifying how the device should
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames be configured. The first (in lexical order) of the network files that
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames matches a given device is applied.</para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>A network file is said to match a device if each of the entries in the
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <literal>[Match]</literal> section matches, or if the section is empty.
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames The following keys are accepted:</para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </listitem>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>The persistent path, as exposed by the udev
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames property <literal>ID_PATH</literal>. May contain shell
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames style globs.</para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </listitem>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>The driver currently bound to the device, as
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames exposed by the udev property <literal>DRIVER</literal>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames of its parent device, or if that is not set the driver
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames device itself.</para>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </listitem>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>The device type, as exposed by the udev property
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </listitem>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames </varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <varlistentry>
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <para>The device name, as exposed by the udev property
3d0434b7f8ce3bfce252ebbe3cabe626ba750d83gregames <literal>INTERFACE</literal>. May contain shell style