From cb03b12ac2c283187a63921ea5e45f8fe8ea31a5 Mon Sep 17 00:00:00 2001 From: Andrew Bartlett Date: Tue, 30 May 2017 20:57:23 +1200 Subject: [PATCH] ldb: Add Doxygen comments for ldb_req_*trusted() functions Signed-off-by: Andrew Bartlett Reviewed-by: Douglas Bagnall --- lib/ldb/include/ldb_module.h | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/lib/ldb/include/ldb_module.h b/lib/ldb/include/ldb_module.h index 91887de2efc..048f6675b1a 100644 --- a/lib/ldb/include/ldb_module.h +++ b/lib/ldb/include/ldb_module.h @@ -247,19 +247,32 @@ void ldb_set_default_dns(struct ldb_context *ldb); int ldb_reply_add_control(struct ldb_reply *ares, const char *oid, bool critical, void *data); /** - mark a request as untrusted. This tells the rootdse module to remove - unregistered controls - */ + mark a request as untrusted. + + This tells the rootdse module to remove unregistered controls + + \param req the request to mark as untrusted +*/ void ldb_req_mark_untrusted(struct ldb_request *req); /** mark a request as trusted. - */ + + This tells the rootdse module to allow unregistered controls + + \param req the request to mark as trusted +*/ void ldb_req_mark_trusted(struct ldb_request *req); /** return true is a request is untrusted - */ + + This indicates the request came across a trust boundary + for example over LDAP + + \param req the request check + \return is req trusted +*/ bool ldb_req_is_untrusted(struct ldb_request *req); /** -- 2.11.4.GIT