| 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) |