summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorThomas Haller <thaller@redhat.com>2020-12-03 08:33:23 +0100
committerThomas Haller <thaller@redhat.com>2020-12-03 08:44:26 +0100
commit8ff4625db98c56474018f2ede6c4d7f66a3d2c4a (patch)
tree5b4a4bf0bac7c5870b8b32eee993671cd78f6141 /man
parent5b9479a72807706dcbe367751f33e4157e6e4f00 (diff)
man: better explain default connection settings in `man NetworkManager.conf`
Diffstat (limited to 'man')
-rw-r--r--man/NetworkManager.conf.xml16
1 files changed, 14 insertions, 2 deletions
diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml
index 1af436bbab..79f18e45e9 100644
--- a/man/NetworkManager.conf.xml
+++ b/man/NetworkManager.conf.xml
@@ -674,6 +674,18 @@ unmanaged-devices=mac:00:22:68:1c:59:b1;mac:00:1E:65:30:D1:C4;interface-name:eth
<para>Specify default values for connections.
</para>
<para>
+ Such default values are only consulted if the corresponding per-connection property
+ explicitly allows for that. That means, all these properties correspond to
+ a property of the connection profile (for example <literal>connection.mud-url</literal>).
+ Only if the per-profile property is set to a special value that indicates to use the
+ default, the default value from NetworkManager.conf is consulted. It depends on the
+ property, which is the special value that indicates fallback to the default, but it
+ usually is something like empty, unset values or special numeric values like 0 or -1.
+ That means the effectively used value can first always be configured for each profile,
+ and these default values only matter if the per-profile values explicitly indicates
+ to use the default from <literal>NetworkManager.conf</literal>.
+ </para>
+ <para>
Example:
<programlisting>
[connection]
@@ -686,8 +698,8 @@ ipv6.ip6-privacy=0
Not all properties can be overwritten, only the following
properties are supported to have their default values configured
(see <link linkend='nm-settings'><citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry></link> for details).
- A default value is only consulted if the corresponding per-connection value
- explicitly allows for that.
+ </para>
+ <para>
<!-- The following comment is used by check-config-options.sh, don't remove it. -->
<!-- start connection defaults -->
<variablelist>