From: Andrew Bartlett <abartlet@samba.org>
Date: Tue, 30 May 2017 09:17:57 +0000 (+1200)
Subject: ldb: Add Doxygen docs for ldb_set_require_private_event_context()
X-Git-Tag: ldb-1.1.30~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=850732ebbb73f3affedd4233a782e680253b4990;p=thirdparty%2Fsamba.git

ldb: Add Doxygen docs for ldb_set_require_private_event_context()

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Douglas Bagnall <douglas.bagnall@catalyst.net.nz>
---

diff --git a/lib/ldb/include/ldb_module.h b/lib/ldb/include/ldb_module.h
index 9fbbe0dcf78..4cbd8dd0328 100644
--- a/lib/ldb/include/ldb_module.h
+++ b/lib/ldb/include/ldb_module.h
@@ -217,6 +217,15 @@ typedef int (*ldb_connect_fn)(struct ldb_context *ldb, const char *url,
 			      unsigned int flags, const char *options[],
 			      struct ldb_module **module);
 
+/**
+ Require that LDB use a private event context for each request
+
+ A private event context may need to be created to avoid nested event
+ loops during ldb_tdb with the locks held.  This indicates that a
+ backend is in use that requires this to hold locks safely.
+
+ \param handle The ldb handle to set the flag on
+ */
 void ldb_set_require_private_event_context(struct ldb_context *ldb);
 
 struct ldb_backend_ops {