aljaz/lightning
1
0
Fork 0
mirror of https://github.com/aljazceru/lightning.git synced 2026-02-23 15:04:19 +01:00
Code Issues Packages Projects Releases Wiki Activity

lightningd: call "shutdown" notification on plugins at shutdown.

Browse Source 
Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
Changelog-Added: Plugins: `shutdown` notification for clean exits.
This commit is contained in:
Rusty Russell
2021-09-03 19:46:18 +09:30
committed by Christian Decker
parent 89c3541c83
commit 1d8aecb44f
6 changed files with 107 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
lightningd/plugin.h
View File

@@ -189,26 +189,6 @@ void plugins_add_default_dir(struct plugins *plugins);
*/
void plugins_init(struct plugins *plugins);
/**
* Free all resources that are held by plugins in the correct order.
*
* This function ensures that the resources dangling off of the plugins struct
* are freed in the correct order. This is necessary since the struct manages
* two orthogonal sets of resources:
*
* - Plugins
* - Hook calls and notifications
*
* The tal hierarchy is organized in a plugin centric way, i.e., the plugins
* may exit in an arbitrary order and they'll unregister pointers in the other
* resources. However this will fail if `tal_free` decides to free one of the
* non-plugin resources (technically a sibling in the allocation tree) before
* the plugins we will get a use-after-free. This function fixes this by
* freeing in the correct order without adding additional child-relationships
* in the allocation structure and without adding destructors.
*/
void plugins_free(struct plugins *plugins);
/**
* Register a plugin for initialization and execution.
*
@@ -271,6 +251,11 @@ bool plugins_send_getmanifest(struct plugins *plugins);
void plugin_kill(struct plugin *plugin, enum log_level loglevel,
const char *fmt, ...);
/**
* Tell all the plugins we're shutting down, and free them.
*/
void shutdown_plugins(struct lightningd *ld);
/**
* Returns the plugin which registers the command with name {cmd_name}
*/
@@ -351,6 +336,17 @@ char *add_plugin_dir(struct plugins *plugins, const char *dir,
*/
void clear_plugins(struct plugins *plugins);
/**
* Send notification to this single plugin, if interested.
*
* Returns true if it was subscribed to the notification.
*/
bool plugin_single_notify(struct plugin *p,
const struct jsonrpc_notification *n TAKES);
/**
* Send notification to all interested plugins.
*/
void plugins_notify(struct plugins *plugins,
const struct jsonrpc_notification *n TAKES);