From: Francis Dupont <fdupont@isc.org>
Date: Sun, 14 Oct 2018 17:24:19 +0000 (+0200)
Subject: [5-netconf-doc-config] More about module change subscriptions
X-Git-Tag: 148-lib-process-servers-without-arguments_base~6
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=b25cf127294f5cbdbb314a5919cb3021f792b960;p=thirdparty%2Fkea.git

[5-netconf-doc-config] More about module change subscriptions
---

diff --git a/doc/guide/netconf.xml b/doc/guide/netconf.xml
index bb4b52e0b0..82e07a5537 100644
--- a/doc/guide/netconf.xml
+++ b/doc/guide/netconf.xml
@@ -310,6 +310,19 @@ ietf-dhcpv6-types          | 2018-01-30 | Imported    |                     |
       they must be copied to the startup datastore.
     </para>
 
+    <para>
+      When a module change callback is subscribed and the running
+      configuration is changed (using <command>sysrepocfg</command>)
+      the callback is called to validate the modified configuration
+      (if <command>validate-changes</command> was not set to false)
+      and a second time to apply it. If the validation failed the
+      callback is still called again but with an ABORT (vs APPLY) event
+      with rollback changes.
+
+      The returned code of the callback on an APPLY event is ignored,
+      i.e. it is too late to refuse a bad configuration.
+    </para>
+
     <para>
       A modified YANG configuration has four ways to be incorrect:
       <orderedlist>