summaryrefslogtreecommitdiff
path: root/man/systemd-networkd.service.xml
blob: 85fa2a4be4f2eae2348d175cd550b40fada69efa (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
<?xml version='1.0'?> <!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<!--
  This file is part of systemd.

  Copyright 2013 Tom Gundersen

  systemd is free software; you can redistribute it and/or modify it
  under the terms of the GNU Lesser General Public License as published by
  the Free Software Foundation; either version 2.1 of the License, or
  (at your option) any later version.

  systemd is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  Lesser General Public License for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->

<refentry id="systemd-networkd.service" conditional='ENABLE_NETWORKD'>

        <refentryinfo>
                <title>systemd-networkd.service</title>
                <productname>systemd</productname>

                <authorgroup>
                        <author>
                                <contrib>Developer</contrib>
                                <firstname>Tom</firstname>
                                <surname>Gundersen</surname>
                                <email>teg@jklm.no</email>
                        </author>
                </authorgroup>
        </refentryinfo>

        <refmeta>
                <refentrytitle>systemd-networkd.service</refentrytitle>
                <manvolnum>8</manvolnum>
        </refmeta>

        <refnamediv>
                <refname>systemd-networkd.service</refname>
                <refname>systemd-networkd</refname>
                <refpurpose>Network manager</refpurpose>
        </refnamediv>

        <refsynopsisdiv>
                <para><filename>systemd-networkd.service</filename></para>
                <para><filename>/usr/lib/systemd/systemd-networkd</filename></para>
        </refsynopsisdiv>

        <refsect1>
                <title>Description</title>

                <para><command>systemd-networkd</command> is a system
                service that manages networks. It detects and configures
                network devices as they appear, as well as creating virtual
                network devices.</para>

                <para>To configure low-level link settings independently of
                networks, see
                <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>

                <para>Network configurations applied before networkd is started
                are not removed, and static configuration applied by networkd
                is not removed when networkd exits. Dynamic configuration applied by
                networkd may also optionally be left in place on shut-down. This ensures
                restarting networkd does not cut the network connection, and, in particular,
                that it is safe to transition between the initrd and the real root,
                and back.</para>

                <para>Nameservers configured in networkd, or received over DHCP
                are exposed in <filename>/run/systemd/network/resolv.conf</filename>.
                This file should not be used directly, but only through a symlink
                from <filename>/etc/resolv.conf</filename>.</para>
        </refsect1>

        <refsect1><title>Configuration Files</title>
                <para>The configuration files are read from the files located in the
                system network directory <filename>/usr/lib/systemd/network</filename>,
                the volatile runtime network directory
                <filename>/run/systemd/network</filename> and the local administration
                network directory <filename>/etc/systemd/network</filename>.</para>

                <para>Networks are configured in <filename>.network</filename> files, see
                <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                and virtual network devices are configured in <filename>.netdev</filename> files, see
                <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
                </para>
        </refsect1>

        <refsect1>
                <title>See Also</title>
                <para>
                        <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
                        <citerefentry><refentrytitle>systemd-network-wait-online.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                </para>
        </refsect1>

</refentry>