about summary refs log tree commit diff
path: root/man/NetworkManager.conf.5
diff options
context:
space:
mode:
authorSebastien Bacher <seb128@ubuntu.com>2021-08-25 15:24:42 +0200
committerSebastien Bacher <seb128@ubuntu.com>2021-08-25 15:24:42 +0200
commitdbb91282fa488964fb20595f9494a9f0e4f36a58 (patch)
tree142bc942e5320b35514cdf03a5f9f47a9b89df0e /man/NetworkManager.conf.5
parent5f2ede3a2813b0e9204befdcfc67509d34be71c6 (diff)
parentcfb80376641fa49137b9996130352697e7f8b436 (diff)
Update upstream source from tag 'upstream/1.32.10'
Update to upstream version '1.32.10'
with Debian dir fcf2778b50b013ede3e7375bc1d829e984175658
Diffstat (limited to 'man/NetworkManager.conf.5')
-rw-r--r--man/NetworkManager.conf.586
1 files changed, 83 insertions, 3 deletions
diff --git a/man/NetworkManager.conf.5 b/man/NetworkManager.conf.5
index 18212687..33850bb0 100644
--- a/man/NetworkManager.conf.5
+++ b/man/NetworkManager.conf.5
@@ -2,12 +2,12 @@
 .\"     Title: NetworkManager.conf
 .\"    Author: 
 .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\"      Date: 06/30/2021
+.\"      Date: 08/18/2021
 .\"    Manual: Configuration
-.\"    Source: NetworkManager 1.32.2
+.\"    Source: NetworkManager 1.32.10
 .\"  Language: English
 .\"
-.TH "NETWORKMANAGER\&.CONF" "5" "" "NetworkManager 1\&.32\&.2" "Configuration"
+.TH "NETWORKMANAGER\&.CONF" "5" "" "NetworkManager 1\&.32\&.10" "Configuration"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -826,6 +826,10 @@ If left unspecified, the default is to not send the DHCP option to the server\&.
 If unspecified or zero, use 50 for VPN profiles and 100 for other profiles\&.
 .RE
 .PP
+\fIipv4\&.required\-timeout\fR
+.RS 4
+.RE
+.PP
 \fIipv4\&.route\-metric\fR
 .RS 4
 .RE
@@ -872,6 +876,10 @@ ipv6\&.ip6\-privacy
 is unset, use the content of "/proc/sys/net/ipv6/conf/default/use_tempaddr" as last fallback\&.
 .RE
 .PP
+\fIipv6\&.required\-timeout\fR
+.RS 4
+.RE
+.PP
 \fIipv6\&.route\-metric\fR
 .RS 4
 .RE
@@ -1054,6 +1062,35 @@ main\&.ignore\-carrier
 setting above\&.
 .RE
 .PP
+\fIkeep\-configuration\fR
+.RS 4
+On startup, NetworkManager tries to not interfere with interfaces that are already configured\&. It does so by generating a in\-memory connection based on the interface current configuration\&.
+.sp
+If this generated connection matches one of the existing persistent connections, the persistent connection gets activated\&. If there is no match, the generated connection gets activated as "external", which means that the connection is considered as active, but NetworkManager doesn\*(Aqt actually touch the interface\&.
+.sp
+It is possible to disable this behavior by setting
+keep\-configuration
+to
+no\&. In this way, on startup NetworkManager always tries to activate the most suitable persistent connection (the one with highest autoconnect\-priority or, in case of a tie, the one activated most recently)\&.
+.sp
+Note that when NetworkManager gets restarted, it stores the previous state in
+/run/NetworkManager; in particular it saves the UUID of the connection that was previously active so that it can be activated again after the restart\&. Therefore,
+keep\-configuration
+does not have any effect on service restart\&.
+.RE
+.PP
+\fIallowed\-connections\fR
+.RS 4
+A list of connections that can be activated on the device\&. See
+the section called \(lqConnection List Format\(rq
+for the syntax to specify a connection\&. If this option is not specified, all connections can be potentially activated on the device, provided that the connection type and other settings match\&.
+.sp
+A notable use case for this is to filter which connections can be activated based on how they were created; see the
+origin
+keyword in
+the section called \(lqConnection List Format\(rq\&.
+.RE
+.PP
 \fIwifi\&.scan\-rand\-mac\-address\fR
 .RS 4
 Configures MAC address randomization of a Wi\-Fi device during scanning\&. This defaults to
@@ -1436,6 +1473,49 @@ interface\-name:vboxnet*,except:interface\-name:vboxnet2
 .RE
 .\}
 .sp
+.SS "Connection List Format"
+.PP
+Connections can be specified using the following format:
+.PP
+.PP
+*
+.RS 4
+Matches every connection\&.
+.RE
+.PP
+uuid:UUID
+.RS 4
+Match the connection by UUID, for example
+"uuid:83037490\-1d17\-4986\-a397\-01f1db3a7fc2"
+.RE
+.PP
+id=ID
+.RS 4
+Match the connection by name\&.
+.RE
+.PP
+origin:ORIGIN
+.RS 4
+Match the connection by origin, stored in the
+org\&.freedesktop\&.NetworkManager\&.origin
+tag of the user setting\&. For example, use
+"except:origin:nm\-initrd\-generator"
+to forbid activation of connections created by the initrd generator\&.
+.RE
+.PP
+except:SPEC
+.RS 4
+Negative match of a connection\&. A negative match has higher priority then the positive matches above\&.
+.sp
+If there is a list consisting only of negative matches, the behavior is the same as if there is also match\-all\&. That means, if none of all the negative matches is satisfied, the overall result is still a positive match\&.
+.RE
+.PP
+SPEC[,;]SPEC
+.RS 4
+Multiple specs can be concatenated with commas or semicolons\&. The order does not matter as matches are either inclusive or negative (except:), with negative matches having higher priority\&.
+.sp
+Backslash is supported to escape the separators \*(Aq;\*(Aq and \*(Aq,\*(Aq, and to express special characters such as newline (\*(Aq\en\*(Aq), tabulator (\*(Aq\et\*(Aq), whitespace (\*(Aq\es\*(Aq) and backslash (\*(Aq\e\e\*(Aq)\&. Whitespace is not a separator but will be trimmed between two specs (unless escaped as \*(Aq\es\*(Aq)\&.
+.RE
 .SH "SEE ALSO"
 .PP
 \fBNetworkManager\fR(8),