diff options
author | Thomas Haller <thaller@redhat.com> | 2020-12-03 08:33:23 +0100 |
---|---|---|
committer | Thomas Haller <thaller@redhat.com> | 2020-12-03 08:44:26 +0100 |
commit | 8ff4625db98c56474018f2ede6c4d7f66a3d2c4a (patch) | |
tree | 5b4a4bf0bac7c5870b8b32eee993671cd78f6141 | |
parent | 5b9479a72807706dcbe367751f33e4157e6e4f00 (diff) | |
download | NetworkManager-8ff4625db98c56474018f2ede6c4d7f66a3d2c4a.tar.gz |
man: better explain default connection settings in `man NetworkManager.conf`
-rw-r--r-- | man/NetworkManager.conf.xml | 16 |
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> |