Debian Codegraph @

upstream/debian-unstable/man8/systemd-networkd.service.8

raw
1 '\" t
2 .TH "SYSTEMD\-NETWORKD\&.SERVICE" "8" "" "systemd 261~rc3" "systemd-networkd.service"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd-networkd.service, systemd-networkd \- Network manager
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-networkd\&.service
27 .PP
28 /usr/lib/systemd/systemd\-networkd
29 .SH "DESCRIPTION"
30 .PP
31 \fBsystemd\-networkd\fR
32 is a system service that manages networks\&. It detects and configures network devices as they appear, as well as creating virtual network devices\&.
33 .PP
34 Certain low\-level settings of physical network devices (e\&.g\&. device names and altnames) as well as the creation of SR\-IOV virtual functions on physical network interfaces may be managed by
35 \fBsystemd-udevd\fR(8)
36 according to the contents of
37 \fBsystemd.link\fR(5)
38 files\&.
39 .PP
40 \fBsystemd\-networkd\fR
41 will create "virtual" network devices (e\&.g\&. bridges and tunnels) based on the configuration in
42 \fBsystemd.netdev\fR(5)
43 files, respecting the [Match] sections in those files\&.
44 .PP
45 \fBsystemd\-networkd\fR
46 will manage network addresses and routes for any link for which it finds a
47 \&.network
48 file with an appropriate [Match] section, see
49 \fBsystemd.network\fR(5)\&. For those links, it will flush existing network addresses and routes when bringing up the device (except when directed not to)\&. Any links not matched by one of the
50 \&.network
51 files will be ignored\&. It is also possible to explicitly tell
52 systemd\-networkd
53 to ignore a link by using the
54 \fIUnmanaged=yes\fR
55 option, see
56 \fBsystemd.network\fR(5)\&.
57 .PP
58 When
59 systemd\-networkd
60 exits, it generally leaves existing network devices and configuration intact\&. This makes it possible to transition from the initrd and to restart the service without breaking connectivity\&. This also means that when configuration is updated and
61 systemd\-networkd
62 is restarted, netdev interfaces for which configuration was removed will not be dropped, and may need to be cleaned up manually\&.
63 .PP
64 \fBsystemd\-networkd\fR
65 may be introspected and controlled at runtime using
66 \fBnetworkctl\fR(1)\&.
67 .PP
68 See
69 \fBorg.freedesktop.network1\fR(5)
70 and
71 \fBorg.freedesktop.LogControl1\fR(5)
72 for a description of the D\-Bus API\&.
73 .SH "CONFIGURATION FILES"
74 .PP
75 The configuration files are read from the files located in the system network directory
76 /usr/lib/systemd/network, the volatile runtime network directory
77 /run/systemd/network
78 and the local administration network directory
79 /etc/systemd/network\&.
80 .PP
81 Networks are configured in
82 \&.network
83 files, see
84 \fBsystemd.network\fR(5), and virtual network devices are configured in
85 \&.netdev
86 files, see
87 \fBsystemd.netdev\fR(5)\&.
88 .SH "SEE ALSO"
89 .PP
90 \fBnetworkctl\fR(1), \fBsystemd\fR(1), \fBsystemd.link\fR(5), \fBsystemd.network\fR(5), \fBsystemd.netdev\fR(5), \fBsystemd-networkd-wait-online.service\fR(8), \fBsystemd-network-generator.service\fR(8), \fBorg.freedesktop.network1\fR(5)