morgan/systemd
1
0
Fork 0
mirror of https://github.com/morgan9e/systemd synced 2026-04-15 00:47:10 +09:00
Code Issues Packages Projects Releases Wiki Activity

man/network: Note .link early boot caveat, and .network .netdev usage.

Browse Source 
Document .link .network and .netdev file type distinctions in early
introductory text, and document distro-specific need to sync link files
with early-boot copies, see Debian bug 1005282:
https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1005282 for an
example.
This commit is contained in:
Tim Small
2025-05-02 13:40:00 +01:00
committed by Yu Watanabe
parent a6619f9678
commit a50fa2a40f
3 changed files with 26 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
man/systemd-networkd.service.xml
View File

@@ -33,12 +33,16 @@
manages networks. It detects and configures network devices as manages networks. It detects and configures network devices as
they appear, as well as creating virtual network devices.</para> they appear, as well as creating virtual network devices.</para>
<para>To configure low-level link settings independently of <para>Certain low-level settings of physical network devices (e.g. device
networks, see names and altnames) as well as the creation of SR-IOV virtual functions on
<citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para> physical network interfaces may be managed by
<citerefentry><refentrytitle>systemd-udevd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
according to the contents of
<citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>
files.</para>
<para><command>systemd-networkd</command> will create network devices based <para><command>systemd-networkd</command> will create "virtual" network
on the configuration in devices (e.g. bridges and tunnels) based on the configuration in
<citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>
files, respecting the [Match] sections in those files.</para> files, respecting the [Match] sections in those files.</para>
@@ -47,10 +51,10 @@
with an appropriate [Match] section, see with an appropriate [Match] section, see
<citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>. <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
For those links, it will flush existing network addresses and routes when For those links, it will flush existing network addresses and routes when
bringing up the device. Any links not matched by one of the bringing up the device (except when directed not to). Any links not matched
<filename>.network</filename> files will be ignored. It is also possible to by one of the <filename>.network</filename> files will be ignored. It is
explicitly tell <filename>systemd-networkd</filename> to ignore a link by also possible to explicitly tell <filename>systemd-networkd</filename> to
using <varname>Unmanaged=yes</varname> option, see ignore a link by using the <varname>Unmanaged=yes</varname> option, see
<citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>. <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>.
</para> </para>

5
man/systemd.link.xml
View File

@@ -33,6 +33,11 @@
<citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>7</manvolnum></citerefentry> for a <citerefentry><refentrytitle>systemd.syntax</refentrytitle><manvolnum>7</manvolnum></citerefentry> for a
general description of the syntax.</para> general description of the syntax.</para>
<para>Note that some distributions may incorporate <filename>.link</filename> files in their early boot
facilities (e.g. by including copies of the <filename>.link</filename> files in initramfs). As such it
may be necessary to take manual steps to ensure that any local changes are consistent with early-boot
storage facilities. The relevant distribution-specific documentation should be consulted.</para>
<para>The <filename>.link</filename> files are read from the files located in the system network <para>The <filename>.link</filename> files are read from the files located in the system network
directory <filename>/usr/lib/systemd/network</filename> and directory <filename>/usr/lib/systemd/network</filename> and
<filename>/usr/local/lib/systemd/network</filename> <filename>/usr/local/lib/systemd/network</filename>

8
man/systemd.network.xml
View File

@@ -37,6 +37,14 @@
<para>The main network file must have the extension <filename>.network</filename>; other <para>The main network file must have the extension <filename>.network</filename>; other
extensions are ignored. Networks are applied to links whenever the links appear.</para> extensions are ignored. Networks are applied to links whenever the links appear.</para>
<para>Note that not all settings and configurations can be made with <filename>.network</filename>
files, and that it may be necessary to use
<citerefentry><refentrytitle>systemd.link</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
or
<citerefentry><refentrytitle>systemd.netdev</refentrytitle><manvolnum>5</manvolnum></citerefentry>)
files in conjuction with <filename>.network</filename> files when working with physical and virtual
network devices respectively.</para>
<para>The <filename>.network</filename> files are read from the files located in the system network <para>The <filename>.network</filename> files are read from the files located in the system network
directories <filename>/usr/lib/systemd/network</filename> and directories <filename>/usr/lib/systemd/network</filename> and
<filename>/usr/local/lib/systemd/network</filename> <filename>/usr/local/lib/systemd/network</filename>