From c2140ad0f32cd510d8a41809213a016c9b53ceea Mon Sep 17 00:00:00 2001 From: Michael Davidsaver Date: Wed, 3 Dec 2025 18:08:54 -0800 Subject: [PATCH] doc clarify callbackRequestDelayed() timer allocation --- modules/database/src/ioc/db/callback.h | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/modules/database/src/ioc/db/callback.h b/modules/database/src/ioc/db/callback.h index 3282c6158..bbfb68713 100644 --- a/modules/database/src/ioc/db/callback.h +++ b/modules/database/src/ioc/db/callback.h @@ -138,7 +138,14 @@ DBCORE_API int callbackRequestProcessCallback( * epicsCallback object must not be modified while queued, * and must remain valid while queued or executing. * - * @param pCallback Callback object. Caller expected to initialize or zero all members. + * epicsCallback::timer must be zeroed before the first call, + * and left unmodified for subsequent calls. + * Each epicsCallback is allocated a timer on first call. + * There is no way to free this allocation. + * Reuse of epicsCallback is strongly recommended. + * + * @param pCallback Callback object. + * Caller expected to initialize or zero all members prior to first call. * @param seconds Relative to call time. Expected to be >= 0. * @return Zero on success. * Errors if callback members not initialized correctly, or if queue is full.