docs-xml/smbdotconf/misc/dsdbeventnotification.xml

   1 <samba:parameter name="dsdb event notification"
   2                  context="G"
   3                  type="boolean"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>When enabled, this option causes Samba (acting as an
   7         Active Directory Domain Controller) to stream Samba database
   8         events across the internal message bus.  Scripts built using
   9         Samba's python bindings can listen to these events by
  10         registering as the service
  11         <filename moreinfo="none">dsdb_event</filename>.</para>
  12
  13         <para>This is <emphasis>not</emphasis> needed for the audit
  14         logging described in <smbconfoption name="log level"/>.</para>
  15
  16         <para>Instead, this should instead be considered a developer
  17         option (it assists in the Samba testsuite) rather than a
  18         facility for external auditing, as message delivery is not
  19         guaranteed (a feature that the testsuite works around).</para>
  20
  21         <para>The Samba database events are also logged via the normal
  22         logging methods when the <smbconfoption name="log level"/> is
  23         set appropriately, say to
  24         <command moreinfo="none">dsdb_json_audit:5</command>.</para>
  25
  26 </description>
  27
  28 <value type="default">no</value>
  29 </samba:parameter>