46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen This file is part of systemd.
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen Copyright 2013 Tom Gundersen
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen systemd is free software; you can redistribute it and/or modify it
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen under the terms of the GNU Lesser General Public License as published by
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen the Free Software Foundation; either version 2.1 of the License, or
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen (at your option) any later version.
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen systemd is distributed in the hope that it will be useful, but
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen WITHOUT ANY WARRANTY; without even the implied warranty of
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen Lesser General Public License for more details.
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen You should have received a copy of the GNU Lesser General Public License
46b0925d4febce47d2d3b4cf83518c330730c3f6Tom Gundersen along with systemd; If not, see <http://www.gnu.org/licenses/>.
2b70d172a7b2ba741df7d6ca89c915e17d6f3e84Tom Gundersen<refentry id="systemd-networkd.service" conditional='ENABLE_NETWORKD'>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>systemd-networkd.service</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd-networkd.service</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>systemd-networkd.service</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refname>systemd-networkd</refname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Network manager</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><filename>systemd-networkd.service</filename></para>
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen <para><filename>/usr/lib/systemd/systemd-networkd</filename></para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek </refsynopsisdiv>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para><command>systemd-networkd</command> is a system service that
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek manages networks. It detects and configures network devices as
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek they appear, as well as creating virtual network devices.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>To configure low-level link settings independently of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Network configurations applied before networkd is started
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek are not removed, and static configuration applied by networkd is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek not removed when networkd exits. Dynamic configuration applied by
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek networkd may also optionally be left in place on shutdown. This
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek ensures restarting networkd does not cut the network connection,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek and, in particular, that it is safe to transition between the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek initrd and the real root, and back.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refsect1><title>Configuration Files</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The configuration files are read from the files located in the
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen system 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 administration
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen network directory <filename>/etc/systemd/network</filename>.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Networks are configured in <filename>.network</filename>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek and virtual network devices are configured in
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <filename>.netdev</filename> files, see
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</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 <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-networkd-wait-online.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>