idmap_autorid: add a comment explaining idmap_autorid_db_init()

Signed-off-by: Michael Adam <obnox@samba.org>
Reviewed-by: Volker Lendecke <vl@samba.org>

diff --git a/source3/include/idmap_autorid_tdb.h b/source3/include/idmap_autorid_tdb.h
index bf96d765d1579b5c508cba5c1ef353f1d3fd800e..f1808d21101eb3c7f5a78eb41fbac46e315d5d95 100644 (file)
--- a/source3/include/idmap_autorid_tdb.h
+++ b/source3/include/idmap_autorid_tdb.h
@@ -87,6 +87,12 @@ NTSTATUS idmap_autorid_setrange(struct db_context *db,
  */
 NTSTATUS idmap_autorid_init_hwm(struct db_context *db, const char *hwm);
 
+/**
+ * Initialize an idmap_autorid database.
+ * After this function has successfully completed, the following are true:
+ * - the database exists
+ * - the required HWM keys exist (range, alloc-uid, alloc-gid)
+ */
 NTSTATUS idmap_autorid_db_init(const char *path,
                               TALLOC_CTX *mem_ctx,
                               struct db_context **db);