mirrors/core-lightning
1
0
Fork 0
mirror of https://github.com/ElementsProject/lightning.git synced 2025-02-22 06:41:44 +01:00
Code Issues Projects Releases Wiki Activity

libplugin: allow freeing in timer callback, clarify docs, allow nested timers.

Browse source 
1. Allow timers to be freed in their callback.
2. Clarify in header that we have to terminate our timer with timer_finished()
   eventually.
3. We don't currently have plugins with more than one outstanding timer, but
   it certainly would be possible, so fix in_timer to be a counter.

Suggested-by: @ZmnSCPxj
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
This commit is contained in:
Rusty Russell 2019-05-21 17:02:31 +09:30 • committed by Christian Decker
parent 9b61c19a20
commit 6a8cd9a016
2 changed files with 16 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
plugins/libplugin.c
View file

@ -29,7 +29,7 @@ static STRMAP(const char *) usagemap;
/* Timers */
static struct timers timers;
static bool in_timer;
static size_t in_timer;
bool deprecated_apis;
@ -244,8 +244,8 @@ command_done_raw(struct command *cmd,
struct command_result *timer_complete(void)
{
assert(in_timer);
in_timer = false;
assert(in_timer > 0);
in_timer--;
return &complete;
}
@ -603,9 +603,10 @@ static void call_plugin_timer(struct plugin_conn *rpc, struct timer *timer)
{
struct plugin_timer *t = container_of(timer, struct plugin_timer, timer);
in_timer = true;
in_timer++;
/* Free this if they don't. */
tal_steal(tmpctx, t);
t->cb();
tal_free(t);
}
static void destroy_plugin_timer(struct plugin_timer *timer)

16
plugins/libplugin.h
View file

@ -38,14 +38,15 @@ struct command_result *command_param_failed(void);
/* Call this on fatal error. */
void NORETURN plugin_err(const char *fmt, ...);
/* This command is finished, here's a detailed error. data can be NULL. */
/* This command is finished, here's a detailed error; @cmd cannot be
* NULL, data can be NULL. */
struct command_result *WARN_UNUSED_RESULT
command_done_err(struct command *cmd,
int code,
const char *errmsg,
const char *data);
/* This command is finished, here's the success msg. */
/* This command is finished, here's the success msg; @cmd cannot be NULL. */
struct command_result *WARN_UNUSED_RESULT
command_success(struct command *cmd, const char *result);
@ -86,24 +87,27 @@ send_outreq_(struct command *cmd,
const jsmntok_t *result), \
(arg), __VA_ARGS__)
/* Callback to just forward error and close request. */
/* Callback to just forward error and close request; @cmd cannot be NULL */
struct command_result *forward_error(struct command *cmd,
const char *buf,
const jsmntok_t *error,
void *arg);
/* Callback to just forward result and close request. */
/* Callback to just forward result and close request; @cmd cannot be NULL */
struct command_result *forward_result(struct command *cmd,
const char *buf,
const jsmntok_t *result,
void *arg);
/* Callback for timer where we expect a 'command_result'. */
/* Callback for timer where we expect a 'command_result'. All timers
* must return this eventually, though they may do so via a convoluted
* send_req() path. */
struct command_result *timer_complete(void);
/* Access timer infrastructure to add a timer.
*
* Freeing this releases the timer (don't free it in timer cb though)
* Freeing this releases the timer, otherwise it's freed after @cb
* if it hasn't been freed already.
*/
struct plugin_timer *plugin_timer(struct plugin_conn *rpc,
struct timerel t,