Function new_lightningd

lightningd/lightningd.c:90–383

~ The core lightning object: it's passed everywhere, and is basically a * global variable. This new_xxx pattern is something we'll see often: * it allocates and initializes a new structure, using *tal*, the hierarchical * allocator. */

 * it allocates and initializes a new structure, using *tal*, the hierarchical
 * allocator. */
static struct lightningd *new_lightningd(const tal_t *ctx)
{
	/*~ tal: each allocation is a child of an existing object (or NULL,
	 * the top-level object).  When an object is freed, all the objects
	 * `tallocated` off it are also freed.  We use it in place of malloc
	 * and free.  For the technically inclined: tal allocations usually
	 * build a tree, and tal_freeing any node in the tree will result in
	 * the entire subtree rooted at that node to be freed.
	 *
	 * It's incredibly useful for grouping object lifetimes, as we'll see.
	 * For example, a `struct lightningd` has a pointer to a `log_book`
	 * which is allocated off the `struct lightningd`, and has its own
	 * internal members allocated off `log_book`: freeing `struct
	 * lightningd` frees them all.
	 *
	 * In this case, freeing `ctx` will free `ld`:
	 */
	struct lightningd *ld = tal(ctx, struct lightningd);

	/*~ Style note: `ctx` is declared `const`, yet we can `tallocate` from
	 * it.  Adding/removing children is not considered to change an
	 * object; nor, in fact, is freeing it with tal_free().  This allows
	 * us to use const more liberally: the style rule here is that you
	 * should use 'const' on pointers if you can. */

	/* They can turn this on with --developer */
	ld->developer = false;

	/*~ We used to EXPLICITLY #if-wrap DEVELOPER code, but as our test
	 * matrix grew, we turned them into a --developer runtime option.
	 * We still use the `dev` prefix everywhere to make the developer-
	 * only variations explicit though. */
	ld->dev_debug_subprocess = NULL;
	ld->dev_no_plugin_checksum = false;
	ld->dev_disconnect_fd = -1;
	ld->dev_subdaemon_fail = false;
	ld->dev_allow_localhost = false;
	ld->dev_fast_gossip = false;
	ld->dev_fast_gossip_prune = false;
	ld->dev_throttle_gossip = false;
	ld->dev_suppress_gossip = false;
	ld->dev_fast_reconnect = false;
	ld->dev_force_privkey = NULL;
	ld->dev_force_bip32_seed = NULL;
	ld->dev_force_channel_secrets = NULL;
	ld->dev_force_channel_secrets_shaseed = NULL;
	ld->dev_force_tmp_channel_id = NULL;
	ld->dev_no_htlc_timeout = false;
	ld->dev_no_version_checks = false;
	ld->dev_max_funding_unconfirmed = 2016;
	ld->dev_low_prio_anchor_blocks = 2016;
	ld->dev_ignore_modern_onion = false;
	ld->dev_disable_commit = -1;
	ld->dev_no_ping_timer = false;
	ld->dev_any_channel_type = false;
	ld->dev_allow_shutdown_destination_change = false;
	ld->dev_hsmd_no_preapprove_check = false;
	ld->dev_hsmd_fail_preapprove = false;