From c9053796b389758e8bacff4cd37d633fd65171f9 Mon Sep 17 00:00:00 2001 From: Andreas Schneider Date: Tue, 11 Dec 2012 17:11:58 +0100 Subject: tdb: Improve the documentation of tdb_reopen() and tdb_close(). Reviewed-by: Simo Sorce Autobuild-User(master): Andreas Schneider Autobuild-Date(master): Wed Dec 12 14:58:50 CET 2012 on sn-devel-104 --- lib/tdb/include/tdb.h | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) (limited to 'lib/tdb') diff --git a/lib/tdb/include/tdb.h b/lib/tdb/include/tdb.h index d19439e760..e371e33876 100644 --- a/lib/tdb/include/tdb.h +++ b/lib/tdb/include/tdb.h @@ -212,9 +212,12 @@ void tdb_set_max_dead(struct tdb_context *tdb, int max_dead); * This can be used after a fork to ensure that we have an independent seek * pointer from our parent and to re-establish locks. * - * @param[in] tdb The database to reopen. + * @param[in] tdb The database to reopen. It will be free'd on error! * * @return 0 on success, -1 on error. + * + * @note Don't call tdb_error() after this function cause the tdb context will + * be freed on error. */ int tdb_reopen(struct tdb_context *tdb); @@ -361,9 +364,12 @@ int tdb_append(struct tdb_context *tdb, TDB_DATA key, TDB_DATA new_dbuf); /** * @brief Close a database. * - * @param[in] tdb The database to close. + * @param[in] tdb The database to close. The context will be free'd. * * @return 0 for success, -1 on error. + * + * @note Don't call tdb_error() after this function cause the tdb context will + * be freed on error. */ int tdb_close(struct tdb_context *tdb); -- cgit