summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorAndrew Zaborowski <andrew.zaborowski@intel.com>2021-05-22 18:46:38 +0200
committerAndrew Zaborowski <balrogg@gmail.com>2021-05-26 16:47:04 +0200
commitb86d83860ebeac9a0e1aecdd5f82526befd63d4e (patch)
treefd847adde43f43b739238d654b9b18c9de8f79c8 /man
parent62dc214033492f97c382aaa029da4730a8f04346 (diff)
downloadNetworkManager-b86d83860ebeac9a0e1aecdd5f82526befd63d4e.tar.gz
iwd: Add default "auto" value for [main].iwd-config-path
Since the [main].iwd-config-path functionality, where NM watches for NMSettingsConnection changes and update IWD network config files with new settings, has proven to work without issues so far, enable it by default. Instead of hardcoding /var/lib/iwd as the value, and since the value can't be probed at NM compile time, query it from IWD's recently- added D-Bus interface for settings when [main].iwd-config-path is either missing or set to the new value "auto".
Diffstat (limited to 'man')
-rw-r--r--man/NetworkManager.conf.xml25
1 files changed, 16 insertions, 9 deletions
diff --git a/man/NetworkManager.conf.xml b/man/NetworkManager.conf.xml
index d8fce34d6e..1a23498322 100644
--- a/man/NetworkManager.conf.xml
+++ b/man/NetworkManager.conf.xml
@@ -497,17 +497,24 @@ no-auto-default=*
<term><varname>iwd-config-path</varname></term>
<listitem>
<para>
- If the value points to an existing directory, Network
- Manager will attempt to write copies of new or modified
- Wi-Fi connection profiles, converted into the IWD
- format, into this directory thus making IWD connection
- properties editable. This will only happen if the IWD
- backend is active meaning that at least one Wi-Fi device
- must exist.
+ If the value is "auto" (the default), IWD is queried for its
+ current state directory when it appears on D-Bus -- the
+ directory where IWD keeps its network configuration files --
+ usually /var/lib/iwd. NetworkManager will then attempt to
+ write copies of new or modified Wi-Fi connection profiles,
+ converted into the IWD format, into this directory thus making
+ IWD connection properties editable. NM will overwrite existing
+ files without preserving their contents.
</para>
<para>
- This allows editing connection profile settings such as
- the 802.1x configuration using Network Manager clients.
+ The path can also be overriden by pointing to a specific
+ existing and writable directory. On the other hand setting
+ this to an empty string or any other value disables the
+ profile conversion mechanism.
+ </para>
+ <para>
+ This mechanism allows editing connection profile settings such
+ as the 802.1x configuration using NetworkManager clients.
Without it such changes have no effect in IWD.
</para>
</listitem>