summary refs log tree commit diff
path: root/docs/api/html/nm-online.html
diff options
context:
space:
mode:
authorMichael Biebl <biebl@debian.org>2022-05-04 15:35:24 +0200
committerMichael Biebl <biebl@debian.org>2022-05-04 15:35:24 +0200
commit9959fdb2e8ddd06f2161798ca0a39c77d67c652d (patch)
tree2ce24a336d2b1c5fd5dec3090db312eded6c78ba /docs/api/html/nm-online.html
parent8c623dddbdebe354cb94bfc559a5371a14865317 (diff)
New upstream version 1.37.92 upstream/1.37.92
Diffstat (limited to 'docs/api/html/nm-online.html')
-rw-r--r--docs/api/html/nm-online.html32
1 files changed, 9 insertions, 23 deletions
diff --git a/docs/api/html/nm-online.html b/docs/api/html/nm-online.html
index 84fef32f..53c2cc52 100644
--- a/docs/api/html/nm-online.html
+++ b/docs/api/html/nm-online.html
@@ -8,7 +8,7 @@
 <link rel="up" href="manpages.html" title="Part I. Manual Pages">
 <link rel="prev" href="nm-settings-ifcfg-rh.html" title="nm-settings-ifcfg-rh">
 <link rel="next" href="nm-initrd-generator.html" title="nm-initrd-generator">
-<meta name="generator" content="GTK-Doc V1.33.0 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -41,14 +41,8 @@
     should be checked (see the return codes below).</p>
 <p>This tool is not very useful to call directly. It is however used by
     <code class="literal">NetworkManager-wait-online.service</code> with
-    <code class="literal">--wait-for-startup</code> argument. This is used to delay
-    the service and indirectly <code class="literal">network-online.target</code>,
-    until networking is up. Don't order your own systemd services after
-    <code class="literal">NetworkManager-wait-online.service</code> directly. Instead
-    if necessary, order your services after <code class="literal">network-online.target</code>.
-    Even better is to have your services react to network changes dynamically
-    and don't order them with respect to <code class="literal">network-online.target</code>
-    at all.
+    <code class="literal">--wait-for-startup</code> argument
+      (see <a class="link" href="NetworkManager-wait-online.service.html" title="NetworkManager-wait-online.service"><span class="citerefentry"><span class="refentrytitle">NetworkManager-wait-online.service</span>(8)</span></a>).
     </p>
 <p>By default, connections have the <code class="literal">ipv4.may-fail</code> and
     <code class="literal">ipv6.may-fail</code> properties set to <code class="literal">yes</code>;
@@ -86,18 +80,8 @@
           <span class="command"><strong>nm-online -s</strong></span> will just return immediately, regardless of the
           current network state.</p>
 <p>There are various ways to affect when startup complete is reached.
-          For example, by setting a connection profile to autoconnect, such a profile
-          possibly will activate during startup and thus delay startup complete being reached.
-          Also, a profile is considered ready when it fully reached the logical <code class="literal">connected</code>
-          state in NetworkManager. That means, properties like <code class="literal">ipv4.may-fail</code> and <code class="literal">ipv6.may-fail</code>
-          affect whether a certain address family is required. Also, the connection property
-          <code class="literal">connection.wait-device-timeout</code> affects whether to wait for
-          the driver to detect a certain device. Generally, a failure of <code class="literal">NetworkManager-wait-online.service</code>
-          indicates a configuration error, where NetworkManager won't be able to reach the
-          desired connectivity state during startup. An example for that are bridge or bond master
-          profiles, that get autoconnected but without activating any slaves. Such master devices
-          hang in activating state indefinitely, and cause <code class="literal">NetworkManager-wait-online.service</code>
-          to fail.
+          For details see
+          <a class="link" href="NetworkManager-wait-online.service.html" title="NetworkManager-wait-online.service"><span class="citerefentry"><span class="refentrytitle">NetworkManager-wait-online.service</span>(8)</span></a>.
           </p>
 </td>
 </tr>
@@ -145,10 +129,12 @@
 <div class="refsect1">
 <a name="see_also"></a><h2>See Also</h2>
 <p><a class="link" href="nmcli.html" title="nmcli"><span class="citerefentry"><span class="refentrytitle">nmcli</span>(1)</span></a>,
-    <a class="link" href="NetworkManager.html" title="NetworkManager"><span class="citerefentry"><span class="refentrytitle">NetworkManager</span>(8)</span></a>.</p>
+    <a class="link" href="NetworkManager.html" title="NetworkManager"><span class="citerefentry"><span class="refentrytitle">NetworkManager</span>(8)</span></a>,
+    <a class="link" href="NetworkManager-wait-online.service.html" title="NetworkManager-wait-online.service"><span class="citerefentry"><span class="refentrytitle">NetworkManager-wait-online.service</span>(8)</span></a>.
+    </p>
 </div>
 </div>
 <div class="footer">
-<hr>Generated by GTK-Doc V1.33.0</div>
+<hr>Generated by GTK-Doc V1.33.1</div>
 </body>
 </html>
\ No newline at end of file