man: extend man NetworkManager-wait-online.service with examples

This commit is contained in:
Thomas Haller
2022-06-30 10:12:50 +02:00
parent e6a33c04eb
commit 78cd45f1b5

View File

@@ -95,6 +95,11 @@
setting). While trying and retrying, NetworkManager is busy until all setting). While trying and retrying, NetworkManager is busy until all
profiles and devices either reached an activated or disconnected state profiles and devices either reached an activated or disconnected state
and no further events are expected. and no further events are expected.
<para>
</para>
Basically, as long as there are devices and connections in <literal>activating</literal>
state visible with <command>nmcli device</command> and <command>nmcli connection</command>,
startup is still pending.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
@@ -120,11 +125,29 @@
This is a configuration error. This is a configuration error.
</para> </para>
</listitem> </listitem>
<listitem>
<para>
Dispatcher scripts for the "pre-up" event run at a late stage during activation
of a profile. These scripts block the activation for when NetworkManager considers
the profile fully activated.
See also <link linkend='NetworkManager-dispatcher'><citerefentry><refentrytitle>NetworkManager-dispatcher</refentrytitle><manvolnum>8</manvolnum></citerefentry></link>
for details.
</para>
</listitem>
<listitem>
<para>
The connection property <literal>connection.wait-activation-delay</literal> also
adds an additional delay during activation and delays startup complete. This is to
workaround certain cases where a device is known to not be ready for a certain
amount of time.
</para>
</listitem>
<listitem> <listitem>
<para> <para>
The property <literal>connection.wait-device-timeout</literal> of the connection The property <literal>connection.wait-device-timeout</literal> of the connection
profiles waits until the waited devices appear. This is useful if the driver profiles waits until the waited devices appear. This is useful if the driver
takes a longer time to detect the networking interfaces. takes a longer time to detect the networking interfaces. Similar with the
<literal>connection.gateway-ping-timeout</literal> property.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>