From: Aki Tuomi <aki.tuomi@open-xchange.com>
Date: Wed, 10 Sep 2025 06:30:13 +0000 (+0300)
Subject: lib-sql: sql-api - Clarify that results are free'd after callback returns
X-Git-Tag: 2.4.2~67
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=1596fff32307e8d5e04aef8b5915a42ee31ff818;p=thirdparty%2Fdovecot%2Fcore.git

lib-sql: sql-api - Clarify that results are free'd after callback returns
---

diff --git a/src/lib-sql/sql-api.h b/src/lib-sql/sql-api.h
index f0333768bf..41dd2f76e4 100644
--- a/src/lib-sql/sql-api.h
+++ b/src/lib-sql/sql-api.h
@@ -84,7 +84,11 @@ struct sql_settings {
 
 extern const struct setting_parser_info sql_setting_parser_info;
 
+/* Called when query finished, note that result will be automatically
+ * unreferenced after callback finishes. */
 typedef void sql_query_callback_t(struct sql_result *result, void *context);
+/* Called when commit finished, note that result will be freed after
+ * callback finishes. */
 typedef void sql_commit_callback_t(const struct sql_commit_result *result, void *context);
 
 void sql_drivers_init(void);