diff options
Diffstat (limited to 'man/NetworkManager.8')
| -rw-r--r-- | man/NetworkManager.8 | 23 |
1 files changed, 18 insertions, 5 deletions
diff --git a/man/NetworkManager.8 b/man/NetworkManager.8 index f4ba4fef..6af6a49e 100644 --- a/man/NetworkManager.8 +++ b/man/NetworkManager.8 @@ -2,12 +2,12 @@ .\" Title: NetworkManager .\" Author: .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/> -.\" Date: 08/03/2016 +.\" Date: 08/24/2016 .\" Manual: Network management daemons -.\" Source: NetworkManager 1.2.4 +.\" Source: NetworkManager 1.4.0 .\" Language: English .\" -.TH "NETWORKMANAGER" "8" "" "NetworkManager 1\&.2\&.4" "Network management daemons" +.TH "NETWORKMANAGER" "8" "" "NetworkManager 1\&.4\&.0" "Network management daemons" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -41,7 +41,9 @@ NetworkManager will execute scripts in the /etc/NetworkManager/dispatcher\&.d di .PP Each script receives two arguments, the first being the interface name of the device an operation just happened on, and second the action\&. For device actions, the interface is the name of the kernel interface suitable for IP configuration\&. Thus it is either VPN_IP_IFACE, DEVICE_IP_IFACE, or DEVICE_IFACE, as applicable\&. For the \fIhostname\fR -action it is always "none"\&. +and +\fIconnectivity\-change\fR +actions it is always "none"\&. .PP The actions are: .PP @@ -100,6 +102,11 @@ The DHCPv4 lease has changed (renewed, rebound, etc)\&. The DHCPv6 lease has changed (renewed, rebound, etc)\&. .RE .PP +\fIconnectivity\-change\fR +.RS 4 +The network connectivity state has changed (no connectivity, went online, etc)\&. +.RE +.PP The environment contains more information about the interface and the connection\&. The following variables are available for the use in the dispatcher scripts: .PP \fICONNECTION_UUID\fR @@ -183,6 +190,11 @@ If the connection used DHCP for address configuration, the received DHCP configu The same variables as for IPv4 are available for IPv6, but the prefixes are IP6_ and DHCP6_ instead\&. .RE .PP +\fICONNECTIVITY_STATE\fR +.RS 4 +The network connectivity state, which can take the values defined by the NMConnectivityState type, from the org\&.freedesktop\&.NetworkManager D\-Bus API: unknown, none, portal, limited or full\&. Note: this variable will only be set for connectivity\-change actions\&. +.RE +.PP In case of VPN, VPN_IP_IFACE is set, and IP4_*, IP6_* variables with VPN prefix are exported too, like VPN_IP4_ADDRESS_0, VPN_IP4_NUM_ADDRESSES\&. .PP Dispatcher scripts are run one at a time, but asynchronously from the main NetworkManager process, and will be killed if they run for too long\&. If your script might take arbitrarily long to complete, you should spawn a child process and have the parent return immediately\&. Scripts that are symbolic links pointing inside the /etc/NetworkManager/dispatcher\&.d/no\-wait\&.d/ directory are run immediately, without waiting for the termination of previous scripts, and in parallel\&. Also beware that once a script is queued, it will always be run, even if a later event renders it obsolete\&. (Eg, if an interface goes up, and then back down again quickly, it is possible that one or more "up" scripts will be run after the interface has gone down\&.) @@ -307,4 +319,5 @@ to enable debug logging inside NetworkManager itself\&. \fBnm-online\fR(1), \fBnm-settings\fR(5), \fBnm-applet\fR(1), -\fBnm-connection-editor\fR(1)\fBudev\fR(7) +\fBnm-connection-editor\fR(1), +\fBudev\fR(7) |