From 1e5977b62f896e844b548c3007ace9e1dfa7f9ed Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Sat, 11 Apr 2020 21:28:04 +0200 Subject: New upstream version 1.23.90 --- man/nm-online.1 | 45 +++++++++++++++++++++++++++++++-------------- 1 file changed, 31 insertions(+), 14 deletions(-) (limited to 'man/nm-online.1') diff --git a/man/nm-online.1 b/man/nm-online.1 index a111451b..5c092960 100644 --- a/man/nm-online.1 +++ b/man/nm-online.1 @@ -2,12 +2,12 @@ .\" Title: nm-online .\" Author: .\" Generator: DocBook XSL Stylesheets vsnapshot -.\" Date: 03/12/2020 +.\" Date: 04/10/2020 .\" Manual: General Commands Manual -.\" Source: NetworkManager 1.22.10 +.\" Source: NetworkManager 1.23.90 .\" Language: English .\" -.TH "NM\-ONLINE" "1" "" "NetworkManager 1\&.22\&.10" "General Commands Manual" +.TH "NM\-ONLINE" "1" "" "NetworkManager 1\&.23\&.90" "General Commands Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -39,15 +39,17 @@ is a utility to find out whether we are online\&. It is done by asking NetworkMa \fBnm\-online\fR waits until NetworkManager reports an active connection, or specified timeout expires\&. On exit, the returned status code should be checked (see the return codes below)\&. .PP -By default NetworkManager waits for IPv4 dynamic addressing to complete but does not wait for the -auto -IPv6 dynamic addressing\&. To wait for IPv6 addressing to complete, either (1) change the network connection\*(Aqs IPv6 -may\-fail -setting to -no, and/or (2) change the IPv6 addressing method to -manual -or -dhcp, to indicate that IPv6 connectivity is expected\&. +This tool is not very useful to call directly\&. It is however used by +NetworkManager\-wait\-online\&.service +with +\-\-wait\-for\-startup +argument\&. This is used to delay the service and indirectly +network\-online\&.target, until networking is up\&. Don\*(Aqt order your own systemd services after +NetworkManager\-wait\-online\&.service +directly\&. Instead if necessary, order your services after +network\-online\&.target\&. Even better is to have your services react to network changes dynamically and don\*(Aqt order them with respect to +network\-online\&.target +at all\&. .SH "OPTIONS" .PP \fB\-h\fR | \fB\-\-help\fR @@ -62,9 +64,24 @@ Don\*(Aqt print anything\&. .PP \fB\-s\fR | \fB\-\-wait\-for\-startup\fR .RS 4 -Wait for NetworkManager startup to complete, rather than waiting for network connectivity specifically\&. Startup is considered complete once NetworkManager has activated (or attempted to activate) every auto\-activate connection which is available given the current network state\&. (This is generally only useful at boot time; after startup has completed, +Wait for NetworkManager startup to complete, rather than waiting for network connectivity specifically\&. Startup is considered complete once NetworkManager has activated (or attempted to activate) every auto\-activate connection which is available given the current network state\&. This corresponds to the moment when NetworkManager logs +"startup complete"\&. This mode is generally only useful at boot time\&. After startup has completed, \fBnm\-online \-s\fR -will just return immediately, regardless of the current network state\&.) +will just return immediately, regardless of the current network state\&. +.sp +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 +connected +state in NetworkManager\&. That means, properties like +ipv4\&.may\-fail +and +ipv6\&.may\-fail +affect whether a certain address family is required\&. Also, the connection property +connection\&.wait\-device\-timeout +affects whether to wait for the driver to detect a certain device\&. Generally, a failure of +NetworkManager\-wait\-online\&.service +indicates a configuration error, where NetworkManager won\*(Aqt 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 +NetworkManager\-wait\-online\&.service +to fail\&. .RE .PP \fB\-t\fR | \fB\-\-timeout\fR \fIseconds\fR -- cgit 1.3.0-6-gf8a5 From d460892bbfece74fb6d3cd846bf6ef548290be41 Mon Sep 17 00:00:00 2001 From: Michael Biebl Date: Fri, 8 May 2020 21:40:53 +0200 Subject: New upstream version 1.24.0 --- man/nm-online.1 | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) (limited to 'man/nm-online.1') diff --git a/man/nm-online.1 b/man/nm-online.1 index 5c092960..3f36cdc8 100644 --- a/man/nm-online.1 +++ b/man/nm-online.1 @@ -2,12 +2,12 @@ .\" Title: nm-online .\" Author: .\" Generator: DocBook XSL Stylesheets vsnapshot -.\" Date: 04/10/2020 +.\" Date: 05/08/2020 .\" Manual: General Commands Manual -.\" Source: NetworkManager 1.23.90 +.\" Source: NetworkManager 1.24.0 .\" Language: English .\" -.TH "NM\-ONLINE" "1" "" "NetworkManager 1\&.23\&.90" "General Commands Manual" +.TH "NM\-ONLINE" "1" "" "NetworkManager 1\&.24\&.0" "General Commands Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -50,6 +50,18 @@ directly\&. Instead if necessary, order your services after network\-online\&.target\&. Even better is to have your services react to network changes dynamically and don\*(Aqt order them with respect to network\-online\&.target at all\&. +.PP +By default, connections have the +ipv4\&.may\-fail +and +ipv6\&.may\-fail +properties set to +yes; this means that NetworkManager waits for one of the two address families to complete configuration before considering the connection activated\&. If you need a specific address family configured before +network\-online\&.target +is reached, set the corresponding +may\-fail +property to +no\&. .SH "OPTIONS" .PP \fB\-h\fR | \fB\-\-help\fR @@ -86,7 +98,9 @@ to fail\&. .PP \fB\-t\fR | \fB\-\-timeout\fR \fIseconds\fR .RS 4 -Time to wait for a connection, in seconds\&. If the option is not provided, the default timeout is 30 seconds\&. +Time to wait for a connection, in seconds\&. If the option is not provided, the environment variable +NM_ONLINE_TIMEOUT +is honored\&. The default timeout is 30 seconds\&. .RE .PP \fB\-x\fR | \fB\-\-exit\fR -- cgit 1.3.0-6-gf8a5