#include <bitcoin-build-config.h>
#include <init.h>
#include <kernel/checks.h>
#include <addrman.h>
#include <banman.h>
#include <blockfilter.h>
#include <chain.h>
#include <chainparams.h>
#include <chainparamsbase.h>
#include <clientversion.h>
#include <common/args.h>
#include <common/system.h>
#include <consensus/amount.h>
#include <consensus/consensus.h>
#include <deploymentstatus.h>
#include <hash.h>
#include <httprpc.h>
#include <httpserver.h>
#include <index/blockfilterindex.h>
#include <index/coinstatsindex.h>
#include <index/txindex.h>
#include <index/txospenderindex.h>
#include <init/common.h>
#include <interfaces/chain.h>
#include <interfaces/init.h>
#include <interfaces/ipc.h>
#include <interfaces/mining.h>
#include <interfaces/node.h>
#include <ipc/exception.h>
#include <kernel/caches.h>
#include <kernel/context.h>
#include <key.h>
#include <logging.h>
#include <mapport.h>
#include <net.h>
#include <net_permissions.h>
#include <net_processing.h>
#include <netbase.h>
#include <netgroup.h>
#include <node/blockmanager_args.h>
#include <node/blockstorage.h>
#include <node/caches.h>
#include <node/chainstate.h>
#include <node/chainstatemanager_args.h>
#include <node/context.h>
#include <node/interface_ui.h>
#include <node/kernel_notifications.h>
#include <node/mempool_args.h>
#include <node/mempool_persist.h>
#include <node/mempool_persist_args.h>
#include <node/miner.h>
#include <node/peerman_args.h>
#include <policy/feerate.h>
#include <policy/fees/block_policy_estimator.h>
#include <policy/fees/block_policy_estimator_args.h>
#include <policy/policy.h>
#include <policy/settings.h>
#include <protocol.h>
#include <rpc/blockchain.h>
#include <rpc/register.h>
#include <rpc/server.h>
#include <rpc/util.h>
#include <scheduler.h>
#include <script/sigcache.h>
#include <sync.h>
#include <torcontrol.h>
#include <txdb.h>
#include <txmempool.h>
#include <util/asmap.h>
#include <util/batchpriority.h>
#include <util/chaintype.h>
#include <util/check.h>
#include <util/fs.h>
#include <util/fs_helpers.h>
#include <util/moneystr.h>
#include <util/result.h>
#include <util/signalinterrupt.h>
#include <util/strencodings.h>
#include <util/string.h>
#include <util/syserror.h>
#include <util/thread.h>
#include <util/threadnames.h>
#include <util/time.h>
#include <util/translation.h>
#include <validation.h>
#include <validationinterface.h>
#include <walletinitinterface.h>
#include <algorithm>
#include <cerrno>
#include <condition_variable>
#include <cstddef>
#include <cstdint>
#include <cstdio>
#include <fstream>
#include <functional>
#include <set>
#include <string>
#include <thread>
#include <vector>
#include <csignal>
#include <sys/stat.h>
#include <boost/signals2/signal.hpp>

Macros
#define	MIN_LEVELDB_FDS 150

Functions
static fs::path	GetPidFile (const ArgsManager &args)

static bool	CreatePidFile (const ArgsManager &args)

static void	RemovePidFile (const ArgsManager &args)

void	InitContext (NodeContext &node)
	Initialize node context shutdown and args variables.

bool	ShutdownRequested (node::NodeContext &node)
	Return whether node shutdown was requested.

void	Interrupt (NodeContext &node)
	Interrupt threads.

void	Shutdown (NodeContext &node)

static void	HandleSIGTERM (int)
	Signal handlers are very limited in what they are allowed to do.

static void	HandleSIGHUP (int)

static void	registerSignalHandler (int signal, void(*handler)(int))

void	SetupServerArgs (ArgsManager &argsman, bool can_listen_ipc)
	Register all arguments with the ArgsManager.

static bool	AppInitServers (NodeContext &node)

void	InitParameterInteraction (ArgsManager &args)
	Parameter interaction: change current parameters depending on various rules.

void	InitLogging (const ArgsManager &args)
	Initialize global loggers.

static void	new_handler_terminate ()

bool	AppInitBasicSetup (const ArgsManager &args, std::atomic< int > &exit_status)
	Initialize bitcoin core: Basic context setup.

bool	AppInitParameterInteraction (const ArgsManager &args)
	Initialization: parameter interaction.

static bool	LockDirectory (const fs::path &dir, bool probeOnly)

static bool	LockDirectories (bool probeOnly)

bool	AppInitSanityChecks (const kernel::Context &kernel)
	Initialization sanity checks.

bool	AppInitLockDirectories ()
	Lock bitcoin core critical directories.

bool	AppInitInterfaces (NodeContext &node)
	Initialize node and wallet interface pointers.

bool	CheckHostPortOptions (const ArgsManager &args)

static std::optional< CService >	CheckBindingConflicts (const CConnman::Options &conn_options)
	Checks for duplicate bindings across all binding configurations.

static ChainstateLoadResult	InitAndLoadChainstate (NodeContext &node, bool do_reindex, const bool do_reindex_chainstate, const kernel::CacheSizes &cache_sizes, const ArgsManager &args)

bool	AppInitMain (NodeContext &node, interfaces::BlockAndHeaderTipInfo *tip_info)
	Bitcoin core main initialization.

bool	StartIndexBackgroundSync (NodeContext &node)
	Validates requirements to run the indexes and spawns each index initial sync thread.

Variables
static constexpr bool	DEFAULT_PROXYRANDOMIZE {true}

static constexpr bool	DEFAULT_REST_ENABLE {false}

static constexpr bool	DEFAULT_I2P_ACCEPT_INCOMING {true}

static constexpr bool	DEFAULT_STOPAFTERBLOCKIMPORT {false}

static constexpr int	MIN_CORE_FDS = MIN_LEVELDB_FDS + NUM_FDS_MESSAGE_CAPTURE

static const char *	BITCOIN_PID_FILENAME = "bitcoind.pid"
	The PID file facilities.

static bool	g_generated_pid {false}
	True if this process has created a PID file.

static std::optional< util::SignalInterrupt >	g_shutdown

Macro Definition Documentation

◆ MIN_LEVELDB_FDS

#define MIN_LEVELDB_FDS 150

Definition at line 163 of file init.cpp.

Function Documentation

◆ AppInitBasicSetup()

bool AppInitBasicSetup	(	const ArgsManager &	args,
		std::atomic< int > &	exit_status )

Initialize bitcoin core: Basic context setup.

Note: This can be done before daemonization. Do not call Shutdown() if this function fails.

Precondition: Parameters should be parsed and config file should be read.

Definition at line 882 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AppInitInterfaces()

bool AppInitInterfaces ( node::NodeContext & node )

Initialize node and wallet interface pointers.

Has no prerequisites or side effects besides allocating memory.

Definition at line 1207 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AppInitLockDirectories()

bool AppInitLockDirectories ( )

Lock bitcoin core critical directories.

Note: This should only be done after daemonization. Do not call Shutdown() if this function fails.

Precondition: Parameters should be parsed and config file should be read, AppInitSanityChecks should have been called.

Definition at line 1195 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AppInitMain()

bool AppInitMain	(	node::NodeContext &	node,
		interfaces::BlockAndHeaderTipInfo *	tip_info = nullptr )

Bitcoin core main initialization.

Note: This should only be done after daemonization. Call Shutdown() if this function fails.

Precondition: Parameters should be parsed and config file should be read, AppInitLockDirectories should have been called.

Definition at line 1421 of file init.cpp.

Here is the caller graph for this function:

◆ AppInitParameterInteraction()

bool AppInitParameterInteraction ( const ArgsManager & args )

Initialization: parameter interaction.

Note: This can be done before daemonization. Do not call Shutdown() if this function fails.

Precondition: Parameters should be parsed and config file should be read, AppInitBasicSetup should have been called.

Definition at line 919 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AppInitSanityChecks()

bool AppInitSanityChecks ( const kernel::Context & kernel )

Initialization sanity checks.

Note: This can be done before daemonization. Do not call Shutdown() if this function fails.

Precondition: Parameters should be parsed and config file should be read, AppInitParameterInteraction should have been called.

Definition at line 1176 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ AppInitServers()

static bool AppInitServers ( NodeContext & node )

static

Definition at line 748 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckBindingConflicts()

static std::optional< CService > CheckBindingConflicts ( const CConnman::Options & conn_options )

static

Checks for duplicate bindings across all binding configurations.

Parameters

[in] conn_options Connection options containing the binding vectors to check

Returns: std::optional<CService> containing the first duplicate found, or std::nullopt if no duplicates

Definition at line 1271 of file init.cpp.

Here is the call graph for this function:

◆ CheckHostPortOptions()

bool CheckHostPortOptions ( const ArgsManager & args )

Definition at line 1216 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CreatePidFile()

static bool CreatePidFile ( const ArgsManager & args )

static

Definition at line 183 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetPidFile()

static fs::path GetPidFile ( const ArgsManager & args )

static

Definition at line 178 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HandleSIGHUP()

static void HandleSIGHUP ( int )

static

Definition at line 432 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ HandleSIGTERM()

static void HandleSIGTERM ( int )

static

Signal handlers are very limited in what they are allowed to do.

The execution context the handler is invoked in is not guaranteed, so we restrict handler operations to just touching variables:

Definition at line 425 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InitAndLoadChainstate()

static ChainstateLoadResult InitAndLoadChainstate	(	NodeContext &	node,
		bool	do_reindex,
		const bool	do_reindex_chainstate,
		const kernel::CacheSizes &	cache_sizes,
		const ArgsManager &	args )

static

Definition at line 1301 of file init.cpp.

Here is the call graph for this function:

◆ InitContext()

void InitContext ( NodeContext & node )

Initialize node context shutdown and args variables.

Definition at line 213 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InitLogging()

void InitLogging ( const ArgsManager & args )

Initialize global loggers.

Initialize the logging infrastructure.

Note that this is called very early in the process lifetime, so you should be careful about what global state you rely on here.

Definition at line 853 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InitParameterInteraction()

void InitParameterInteraction ( ArgsManager & args )

Parameter interaction: change current parameters depending on various rules.

Definition at line 764 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Interrupt()

void Interrupt ( NodeContext & node )

Interrupt threads.

Definition at line 268 of file init.cpp.

Here is the call graph for this function:

◆ LockDirectories()

static bool LockDirectories ( bool probeOnly )

static

Definition at line 1170 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ LockDirectory()

static bool LockDirectory	(	const fs::path &	dir,
		bool	probeOnly )

static

Definition at line 1158 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ new_handler_terminate()

static void new_handler_terminate ( )

static

Definition at line 869 of file init.cpp.

Here is the caller graph for this function:

◆ registerSignalHandler()

static void registerSignalHandler	(	int	signal,
		void(*)(int)	handler )

static

Definition at line 449 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ RemovePidFile()

static void RemovePidFile ( const ArgsManager & args )

static

Definition at line 201 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetupServerArgs()

void SetupServerArgs	(	ArgsManager &	argsman,
		bool	can_listen_ipc )

Register all arguments with the ArgsManager.

Definition at line 459 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Shutdown()

void Shutdown ( NodeContext & node )

Note: Shutdown() must be able to handle cases in which initialization failed part of the way, for example if the data directory was found to be locked. Be sure that anything that writes files or flushes caches only does this if the respective module was initialized.

Definition at line 288 of file init.cpp.

Here is the call graph for this function:

◆ ShutdownRequested()

bool ShutdownRequested ( node::NodeContext & node )

Return whether node shutdown was requested.

Definition at line 250 of file init.cpp.

◆ StartIndexBackgroundSync()

bool StartIndexBackgroundSync ( NodeContext & node )

Validates requirements to run the indexes and spawns each index initial sync thread.

Definition at line 2315 of file init.cpp.

Here is the call graph for this function:

Variable Documentation

◆ BITCOIN_PID_FILENAME

const char* BITCOIN_PID_FILENAME = "bitcoind.pid"

static

The PID file facilities.

Definition at line 171 of file init.cpp.

◆ DEFAULT_I2P_ACCEPT_INCOMING

constexpr bool DEFAULT_I2P_ACCEPT_INCOMING {true}

staticconstexpr

Definition at line 154 of file init.cpp.

◆ DEFAULT_PROXYRANDOMIZE

constexpr bool DEFAULT_PROXYRANDOMIZE {true}

staticconstexpr

Definition at line 152 of file init.cpp.

◆ DEFAULT_REST_ENABLE

constexpr bool DEFAULT_REST_ENABLE {false}

staticconstexpr

Definition at line 153 of file init.cpp.

◆ DEFAULT_STOPAFTERBLOCKIMPORT

constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT {false}

staticconstexpr

Definition at line 155 of file init.cpp.

◆ g_generated_pid

bool g_generated_pid {false}

static

True if this process has created a PID file.

Used to determine whether we should remove the PID file on shutdown.

Definition at line 176 of file init.cpp.

◆ g_shutdown

std::optional<util::SignalInterrupt> g_shutdown

static

Definition at line 211 of file init.cpp.

◆ MIN_CORE_FDS

constexpr int MIN_CORE_FDS = MIN_LEVELDB_FDS + NUM_FDS_MESSAGE_CAPTURE

staticconstexpr

Definition at line 166 of file init.cpp.

Macros

Functions

Variables

Macro Definition Documentation

◆ MIN_LEVELDB_FDS

Function Documentation

◆ AppInitBasicSetup()

◆ AppInitInterfaces()

◆ AppInitLockDirectories()

◆ AppInitMain()

◆ AppInitParameterInteraction()

◆ AppInitSanityChecks()

◆ AppInitServers()

◆ CheckBindingConflicts()

◆ CheckHostPortOptions()

◆ CreatePidFile()

◆ GetPidFile()

◆ HandleSIGHUP()

◆ HandleSIGTERM()

◆ InitAndLoadChainstate()

◆ InitContext()

◆ InitLogging()

◆ InitParameterInteraction()

◆ Interrupt()

◆ LockDirectories()

◆ LockDirectory()

◆ new_handler_terminate()

◆ registerSignalHandler()

◆ RemovePidFile()

◆ SetupServerArgs()

◆ Shutdown()

◆ ShutdownRequested()

◆ StartIndexBackgroundSync()

Variable Documentation

◆ BITCOIN_PID_FILENAME

◆ DEFAULT_I2P_ACCEPT_INCOMING

◆ DEFAULT_PROXYRANDOMIZE

◆ DEFAULT_REST_ENABLE

◆ DEFAULT_STOPAFTERBLOCKIMPORT

◆ g_generated_pid

◆ g_shutdown

◆ MIN_CORE_FDS