#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 <deploymentstatus.h>
#include <hash.h>
#include <httprpc.h>
#include <httpserver.h>
#include <index/blockfilterindex.h>
#include <index/coinstatsindex.h>
#include <index/txindex.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 <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.h>
#include <policy/fees_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 <condition_variable>
#include <cstdint>
#include <cstdio>
#include <fstream>
#include <functional>
#include <set>
#include <string>
#include <thread>
#include <vector>
#include <cerrno>
#include <signal.h>
#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. More...

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

void	Interrupt (NodeContext &node)
	Interrupt threads. More...

void	Shutdown (NodeContext &node)

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

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. More...

static bool	AppInitServers (NodeContext &node)

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

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

static void	new_handler_terminate ()

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

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

static bool	LockDataDirectory (bool probeOnly)

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

bool	AppInitLockDataDirectory ()
	Lock bitcoin core data directory. More...

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

bool	CheckHostPortOptions (const ArgsManager &args)

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

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

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

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 *	DEFAULT_ASMAP_FILENAME ="ip_asn.map"

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

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

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

Macro Definition Documentation

◆ MIN_LEVELDB_FDS

#define MIN_LEVELDB_FDS 150

Definition at line 155 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 830 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 1120 of file init.cpp.

Here is the caller graph for this function:

◆ AppInitLockDataDirectory()

bool AppInitLockDataDirectory ( )

Lock bitcoin core data directory.

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 1108 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, AppInitLockDataDirectory should have been called.

Definition at line 1272 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 867 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 1089 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 697 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ CheckHostPortOptions()

bool CheckHostPortOptions ( const ArgsManager & args )

Definition at line 1127 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 176 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 171 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 416 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 409 of file init.cpp.

Here is the caller graph for this function:

◆ InitAndLoadChainstate()

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

static

Definition at line 1176 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ InitContext()

void InitContext ( NodeContext & node )

Initialize node context shutdown and args variables.

Definition at line 206 of file init.cpp.

Here is the call 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 801 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 713 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 263 of file init.cpp.

Here is the call graph for this function:

◆ LockDataDirectory()

static bool LockDataDirectory ( bool probeOnly )

static

Definition at line 1075 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 817 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 433 of file init.cpp.

Here is the caller graph for this function:

◆ RemovePidFile()

static void RemovePidFile ( const ArgsManager & args )

static

Definition at line 194 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 443 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 281 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 245 of file init.cpp.

Here is the caller graph for this function:

◆ StartIndexBackgroundSync()

bool StartIndexBackgroundSync ( NodeContext & node )

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

Definition at line 2023 of file init.cpp.

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

◆ BITCOIN_PID_FILENAME

const char* BITCOIN_PID_FILENAME = "bitcoind.pid"

static

The PID file facilities.

Definition at line 164 of file init.cpp.

◆ DEFAULT_ASMAP_FILENAME

const char* DEFAULT_ASMAP_FILENAME ="ip_asn.map"

static

Definition at line 159 of file init.cpp.

◆ DEFAULT_I2P_ACCEPT_INCOMING

constexpr bool DEFAULT_I2P_ACCEPT_INCOMING {true}

staticconstexpr

Definition at line 146 of file init.cpp.

◆ DEFAULT_PROXYRANDOMIZE

constexpr bool DEFAULT_PROXYRANDOMIZE {true}

staticconstexpr

Definition at line 144 of file init.cpp.

◆ DEFAULT_REST_ENABLE

constexpr bool DEFAULT_REST_ENABLE {false}

staticconstexpr

Definition at line 145 of file init.cpp.

◆ DEFAULT_STOPAFTERBLOCKIMPORT

constexpr bool DEFAULT_STOPAFTERBLOCKIMPORT {false}

staticconstexpr

Definition at line 147 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 169 of file init.cpp.

◆ g_shutdown

std::optional<util::SignalInterrupt> g_shutdown

static

Definition at line 204 of file init.cpp.

◆ MIN_CORE_FDS

constexpr int MIN_CORE_FDS = MIN_LEVELDB_FDS + NUM_FDS_MESSAGE_CAPTURE

staticconstexpr

Definition at line 158 of file init.cpp.

Macros

Functions

Variables

Macro Definition Documentation

◆ MIN_LEVELDB_FDS

Function Documentation

◆ AppInitBasicSetup()

◆ AppInitInterfaces()

◆ AppInitLockDataDirectory()

◆ AppInitMain()

◆ AppInitParameterInteraction()

◆ AppInitSanityChecks()

◆ AppInitServers()

◆ CheckHostPortOptions()

◆ CreatePidFile()

◆ GetPidFile()

◆ HandleSIGHUP()

◆ HandleSIGTERM()

◆ InitAndLoadChainstate()

◆ InitContext()

◆ InitLogging()

◆ InitParameterInteraction()

◆ Interrupt()

◆ LockDataDirectory()

◆ new_handler_terminate()

◆ registerSignalHandler()

◆ RemovePidFile()

◆ SetupServerArgs()

◆ Shutdown()

◆ ShutdownRequested()

◆ StartIndexBackgroundSync()

Variable Documentation

◆ BITCOIN_PID_FILENAME

◆ DEFAULT_ASMAP_FILENAME

◆ DEFAULT_I2P_ACCEPT_INCOMING

◆ DEFAULT_PROXYRANDOMIZE

◆ DEFAULT_REST_ENABLE

◆ DEFAULT_STOPAFTERBLOCKIMPORT

◆ g_generated_pid

◆ g_shutdown

◆ MIN_CORE_FDS