From bb2ae29a2cc23119c240e9180f7990115f9ac3f8 Mon Sep 17 00:00:00 2001
From: Michael Adam <obnox@samba.org>
Date: Wed, 6 Feb 2008 22:56:08 +0000
Subject: Document new smb.conf options "ldap debug level" and "ldap debug
 threshold".

Michael
(This used to be commit 81a7ca0afbcbf0b23ca0c9ccd4ac3faae89d62bf)
---
 docs/smbdotconf/logging/ldapdebuglevel.xml     | 28 ++++++++++++++++++++++++++
 docs/smbdotconf/logging/ldapdebugthreshold.xml | 16 +++++++++++++++
 2 files changed, 44 insertions(+)
 create mode 100644 docs/smbdotconf/logging/ldapdebuglevel.xml
 create mode 100644 docs/smbdotconf/logging/ldapdebugthreshold.xml

diff --git a/docs/smbdotconf/logging/ldapdebuglevel.xml b/docs/smbdotconf/logging/ldapdebuglevel.xml
new file mode 100644
index 0000000000..5f167ef920
--- /dev/null
+++ b/docs/smbdotconf/logging/ldapdebuglevel.xml
@@ -0,0 +1,28 @@
+<samba:parameter name="ldap debug level"
+		 type="integer"
+		context="G"
+		developer="1" advanced="1"
+		xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+	<para>
+		This parameter controls the debug level of the LDAP library
+		calls. In the case of OpenLDAP, it is the same
+		bit-field as understood by the server and documented in the
+		<citerefentry>
+			<refentrytitle>slapd.conf</refentrytitle>
+			<manvolnum>5</manvolnum>
+		</citerefentry>
+		manpage.
+		A typical useful value will be
+		<emphasis>1</emphasis> for tracing function calls.
+	</para>
+	<para>
+		The debug ouput from the LDAP libraries appears with a
+		prefix [LDAP] in samba's logging output.
+		The level at which LDAP logging is printed is controlled by the
+		parameter <parameter>ldap debug threshold</parameter>.
+	</para>
+</description>
+<value type="default">0</value>
+<value type="example">1</value>
+</samba:parameter>
diff --git a/docs/smbdotconf/logging/ldapdebugthreshold.xml b/docs/smbdotconf/logging/ldapdebugthreshold.xml
new file mode 100644
index 0000000000..a8b20839ee
--- /dev/null
+++ b/docs/smbdotconf/logging/ldapdebugthreshold.xml
@@ -0,0 +1,16 @@
+<samba:parameter name="ldap debug threshold"
+		type="integer"
+		context="G"
+		developer="1" advanced="1"
+		xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+	<para>
+		This parameter controls the samba debug level at which
+		the ldap library debug output is
+		printed in the samba logs. See the description of
+		<parameter>ldap debug level</parameter> for details.
+	</para>
+</description>
+<value type="default">10</value>
+<value type="example">5</value>
+</samba:parameter>
-- 
cgit