summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorThomas Haller <thaller@redhat.com>2019-02-14 12:07:27 +0100
committerThomas Haller <thaller@redhat.com>2019-05-28 17:51:24 +0200
commit1ae5e6465fd04c17c2d5845f33285b941aab0e1a (patch)
tree5ea05223d5568dcb1b1c345c24296ad4ceba0201 /man
parent48b3a3e311d1d8eb1cfb9523e288b501180ac6fd (diff)
downloadNetworkManager-1ae5e6465fd04c17c2d5845f33285b941aab0e1a.tar.gz
settings: drop deprecated NetworkManager.conf option "main.monitor-connection-files"
It's deprecated and off by default for a long time. It is bad to automatically reload connection profiles. For example, ifcfg files may consist of multiple files, there is no guarantee that we pick up the connection when it's fully written. Just don't do this anymore. Users should use D-Bus API or `nmcli connection reload` or `nmcli connection load $FILENAME` to reload profiles from disk.
Diffstat (limited to 'man')
-rw-r--r--man/NetworkManager.conf.xml24
1 files changed, 1 insertions, 23 deletions
diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml
index fc02af4fa5..ec49fcdb88 100644
--- a/man/NetworkManager.conf.xml
+++ b/man/NetworkManager.conf.xml
@@ -153,29 +153,7 @@ plugins-=remove-me
</varlistentry>
<varlistentry>
<term><varname>monitor-connection-files</varname></term>
- <listitem><para>Whether the configured settings plugin(s)
- should set up file monitors and immediately pick up changes
- made to connection files while NetworkManager is running. This
- is disabled by default; NetworkManager will only read
- the connection files at startup, and when explicitly requested
- via the ReloadConnections D-Bus call. If this key is set to
- '<literal>true</literal>', then NetworkManager will reload
- connection files any time they changed.
- Automatic reloading is not advised because there are race conditions
- involved and it depends on the way how the editor updates the file.
- In some situations, NetworkManager might first delete and add the
- connection anew, instead of updating the existing one. Also, NetworkManager
- might pick up incomplete settings while the user is still editing the files.
- </para><para>
- Note that neither this setting nor restarting the NetworkManager daemon
- is the advised way to reload connection profiles from disk. Instead, after
- modifying the files reload them with <command>nmcli connection reload</command>
- or <command>nmcli connection load "$FILENAME"</command>. Even better,
- instead of modifying files directly, use NetworkManager tools like
- <command>nmcli</command>, <command>nmtui</command> or the GUI.
- </para><para>
- This setting is deprecated and will have no effect in the future.
- </para></listitem>
+ <listitem><para>This setting is deprecated and has no effect.</para></listitem>
</varlistentry>
<varlistentry>
<term><varname>auth-polkit</varname></term>