Bug 9060: Minor update to inline documentation for new flag

[controller.git] / opendaylight / md-sal / mdsal-trace / api / src / main / yang / mdsaltrace.yang

diff --git a/opendaylight/md-sal/mdsal-trace/api/src/main/yang/mdsaltrace.yang b/opendaylight/md-sal/mdsal-trace/api/src/main/yang/mdsaltrace.yang
index ce72da750811bea070d51aa69ff7aa3130e2bfe3..3761fa9c1da7318b47a8219e60d467e55ed7a124 100644 (file)
--- a/opendaylight/md-sal/mdsal-trace/api/src/main/yang/mdsaltrace.yang
+++ b/opendaylight/md-sal/mdsal-trace/api/src/main/yang/mdsaltrace.yang
@@ -18,11 +18,22 @@ module mdsaltrace {
     }
 
     container config {
     }
 
     container config {

+        // TODO leaf enabled ...

         leaf-list registration-watches {
             type string;
         }
         leaf-list write-watches {
             type string;
         }
         leaf-list registration-watches {
             type string;
         }
         leaf-list write-watches {
             type string;
         }

+        leaf transaction-debug-context-enabled {
+            default false;
+            type boolean;
+            description "Enable or disable transaction context debug. This will preserve the call site trace for
+                         transactions, so that the original caller of un-close'd() transaction can be identified.
+                         NB: This is a different property from the equally named one in etc/org.opendaylight.controller.cluster.datastore.cfg;
+                         that one does something somewhat similar, but serves to include the stack trace on failed transaction submit,
+                         whereas this one is specific to odl-mdsal-trace's trace:transaction leak troubleshooting command.";
+            // This ^^^ description is also copy/pasted in mdsaltrace_config.xml, and should be kept in line.]
+        }

     }
 }
     }
 }