summaryrefslogtreecommitdiff
path: root/man/systemd-networkd-wait-online.service.xml
diff options
context:
space:
mode:
authorYu Watanabe <watanabe.yu+github@gmail.com>2022-01-28 15:30:01 +0900
committerDaan De Meyer <daan.j.demeyer@gmail.com>2022-01-28 12:52:52 +0000
commit674df18a32e6bb865ae84d39eaf8a5e5f10c7adc (patch)
treea4f35f7d415fc4b2e6352a4a2fffaf5b515701bb /man/systemd-networkd-wait-online.service.xml
parent6c66575f0b96f7afa44c9d30ca3bab50bc55c44d (diff)
downloadsystemd-674df18a32e6bb865ae84d39eaf8a5e5f10c7adc.tar.gz
unit: introduce wait-online@.service for specific interface
This should be useful when a host has multiple interfaces. Inspired by #22246.
Diffstat (limited to 'man/systemd-networkd-wait-online.service.xml')
-rw-r--r--man/systemd-networkd-wait-online.service.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/man/systemd-networkd-wait-online.service.xml b/man/systemd-networkd-wait-online.service.xml
index 9c6b02ac1c..a3a70db209 100644
--- a/man/systemd-networkd-wait-online.service.xml
+++ b/man/systemd-networkd-wait-online.service.xml
@@ -18,12 +18,14 @@
<refnamediv>
<refname>systemd-networkd-wait-online.service</refname>
+ <refname>systemd-networkd-wait-online@.service</refname>
<refname>systemd-networkd-wait-online</refname>
<refpurpose>Wait for network to come online</refpurpose>
</refnamediv>
<refsynopsisdiv>
<para><filename>systemd-networkd-wait-online.service</filename></para>
+ <para><filename>systemd-networkd-wait-online@.service</filename></para>
<para><filename>/usr/lib/systemd/systemd-networkd-wait-online</filename></para>
</refsynopsisdiv>
@@ -38,6 +40,17 @@
to be fully configured or failed, and for at least one link to be online. Here, online means that
the link's operational state is equal or higher than <literal>degraded</literal>. The threshold
can be configured by <option>--operational-state=</option> option.</para>
+
+ <para>The service <filename>systemd-networkd-wait-online.service</filename> invokes
+ <command>systemd-networkd-wait-online</command> without any options. Thus, it waits for all managed
+ interfaces to be configured or failed, and for at least one to be online.</para>
+
+ <para>The service <filename>systemd-networkd-wait-online@.service</filename> takes an interface
+ name, and invokes <command>systemd-networkd-wait-online</command> with <option>-i</option> and the
+ specified interface name. Thus, wait for the specified interface to be configured and online. For
+ example, <filename>systemd-networkd-wait-online@eth0.service</filename> waits for
+ <filename>eth0</filename> to be configured by <command>systemd-networkd</command> and online.
+ </para>
</refsect1>
<refsect1>