[PATCH 2/2] doc: document externally managed profiles

Matthias Kurz <[email protected]> Tue, 28 Apr 2026 13:47:57 +0200
Newsgroups dev.linux.lists.iwd
Message-ID <[email protected]>
Document [Settings].ExternallyManaged in iwd.network. The setting
marks profiles that IWD may read but must not update during normal
network operation, while explicit removal remains allowed.
---
 src/iwd.network.rst | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/iwd.network.rst b/src/iwd.network.rst
index 892c6eb8..2b5c3f0e 100644
--- a/src/iwd.network.rst
+++ b/src/iwd.network.rst
@@ -174,6 +174,14 @@ The group ``[Settings]`` contains general settings.
        Properly configured Access Points will typically update this setting
        appropriately via Transition Disable indications.  User customization
        of this value is thus typically not required.
+   * - ExternallyManaged
+     - Values: true, **false**
+
+       If enabled, the profile contents are managed by an external
+       application.  IWD will read the profile but will not update it as a
+       side effect of network operation, for example to persist connection
+       metadata or security material learned at runtime.  Explicit profile
+       removal through the KnownNetwork Forget method is still allowed.
    * - UseDefaultEccGroup
      - Values: true, false
 
-- 
2.54.0