READ THE CODE

Inside Bitcoin

The code behind the network, with room to understand it.

Stable release v32.1bitcoin/bitcoin · f0de87f04062 ↗3,020 source files · 47.5 MB stored on the server340 file guides

Release published 2026-10-28 · Snapshot fetched 2026-11-01. Latest stable release at fetch time; development branches and Git history are excluded. Only the selected code window and visible folders load here.

10,266 bytes · SHA-256 c85d236cd0fe9543… · View upstream ↗

1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-present The Bitcoin Core developers
3// Distributed under the MIT software license, see the accompanying
4// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6#include <bitcoin-build-config.h> // IWYU pragma: keep
7
8#include <chainparams.h>
9#include <clientversion.h>
10#include <common/args.h>
11#include <common/init.h>
12#include <common/license_info.h>
13#include <common/system.h>
14#include <compat/compat.h>
15#include <init.h>
16#include <interfaces/chain.h>
17#include <interfaces/init.h>
18#include <kernel/context.h>
19#include <logging.h>
20#include <node/context.h>
21#include <node/interface_ui.h>
22#include <node/warnings.h>
23#include <noui.h>
24#include <util/check.h>
25#include <util/exception.h>
26#include <util/signalinterrupt.h>
27#include <util/strencodings.h>
28#include <util/syserror.h>
29#include <util/threadnames.h>
30#include <util/tokenpipe.h>
31#include <util/translation.h>
32
33#include <any>
34#include <functional>
35#include <optional>
36
37using node::NodeContext;
38
39const TranslateFn G_TRANSLATION_FUN{nullptr};
40
41#if HAVE_DECL_FORK
42
43/** Custom implementation of daemon(). This implements the same order of operations as glibc.
44 * Opens a pipe to the child process to be able to wait for an event to occur.
45 *
46 * @returns 0 if successful, and in child process.
47 *          >0 if successful, and in parent process.
48 *          -1 in case of error (in parent process).
49 *
50 *          In case of success, endpoint will be one end of a pipe from the child to parent process,
51 *          which can be used with TokenWrite (in the child) or TokenRead (in the parent).
52 */
53int fork_daemon(bool nochdir, bool noclose, TokenPipeEnd& endpoint)
54{
55    // communication pipe with child process
56    std::optional<TokenPipe> umbilical = TokenPipe::Make();
57    if (!umbilical) {
58        return -1; // pipe or pipe2 failed.
59    }
60
61    int pid = fork();
62    if (pid < 0) {
63        return -1; // fork failed.
64    }
65    if (pid != 0) {
66        // Parent process gets read end, closes write end.
67        endpoint = umbilical->TakeReadEnd();
68        umbilical->TakeWriteEnd().Close();
69
70        int status = endpoint.TokenRead();
71        if (status != 0) { // Something went wrong while setting up child process.
72            endpoint.Close();
73            return -1;
74        }
75
76        return pid;
77    }
78    // Child process gets write end, closes read end.
79    endpoint = umbilical->TakeWriteEnd();
80    umbilical->TakeReadEnd().Close();
81
82#if HAVE_DECL_SETSID
83    if (setsid() < 0) {
84        exit(1); // setsid failed.
85    }
86#endif
87
88    if (!nochdir) {
89        if (chdir("/") != 0) {
90            exit(1); // chdir failed.
91        }
92    }
93    if (!noclose) {
94        // Open /dev/null, and clone it into STDIN, STDOUT and STDERR to detach
95        // from terminal.
96        int fd = open("/dev/null", O_RDWR);
97        if (fd >= 0) {
98            bool err = dup2(fd, STDIN_FILENO) < 0 || dup2(fd, STDOUT_FILENO) < 0 || dup2(fd, STDERR_FILENO) < 0;
99            // Don't close if fd<=2 to try to handle the case where the program was invoked without any file descriptors open.
100            if (fd > 2) close(fd);
101            if (err) {
102                exit(1); // dup2 failed.
103            }
104        } else {
105            exit(1); // open /dev/null failed.
106        }
107    }
108    endpoint.TokenWrite(0); // Success
109    return 0;
110}
111
112#endif
113
114static bool ParseArgs(NodeContext& node, int argc, char* argv[])
115{
116    ArgsManager& args{*Assert(node.args)};
117    // If Qt is used, parameters/bitcoin.conf are parsed in qt/bitcoin.cpp's main()
118    SetupServerArgs(args, node.init->canListenIpc());
119    std::string error;
120    if (!args.ParseParameters(argc, argv, error)) {
121        return InitError(Untranslated(strprintf("Error parsing command line arguments: %s", error)));
122    }
123
124    if (auto error = common::InitConfig(args)) {
125        return InitError(error->message, error->details);
126    }
127
128    // Error out when loose non-argument tokens are encountered on command line
129    for (int i = 1; i < argc; i++) {
130        if (!IsSwitchChar(argv[i][0])) {
131            return InitError(Untranslated(strprintf("Command line contains unexpected token '%s', see bitcoind -h for a list of options.", argv[i])));
132        }
133    }
134    return true;
135}
136
137static bool ProcessInitCommands(interfaces::Init& init, ArgsManager& args)
138{
139    // Process help and version before taking care about datadir
140    if (HelpRequested(args) || args.GetBoolArg("-version", false)) {
141        std::string strUsage = CLIENT_NAME " daemon version " + FormatFullVersion();
142        if (const char* exe_name{init.exeName()}) {
143            strUsage += " ";
144            strUsage += exe_name;
145        }
146        strUsage += "\n";
147
148        if (args.GetBoolArg("-version", false)) {
149            strUsage += FormatParagraph(LicenseInfo());
150        } else {
151            strUsage += "\n"
152                "The " CLIENT_NAME " daemon (bitcoind) is a headless program that connects to the Bitcoin network to validate and relay transactions and blocks, as well as relaying addresses.\n\n"
153                "It provides the backbone of the Bitcoin network and its RPC, REST and ZMQ services can provide various transaction, block and address-related services.\n\n"
154                "There is an optional wallet component which provides transaction services.\n\n"
155                "It can be used in a headless environment or as part of a server setup.\n"
156                "\n"
157                "Usage: bitcoind [options]\n"
158                "\n";
159            strUsage += args.GetHelpMessage();
160        }
161
162        tfm::format(std::cout, "%s", strUsage);
163        return true;
164    }
165
166    return false;
167}
168
169static bool AppInit(NodeContext& node)
170{
171    bool fRet = false;
172    ArgsManager& args = *Assert(node.args);
173
174#if HAVE_DECL_FORK
175    // Communication with parent after daemonizing. This is used for signalling in the following ways:
176    // - a boolean token is sent when the initialization process (all the Init* functions) have finished to indicate
177    // that the parent process can quit, and whether it was successful/unsuccessful.
178    // - an unexpected shutdown of the child process creates an unexpected end of stream at the parent
179    // end, which is interpreted as failure to start.
180    TokenPipeEnd daemon_ep;
181#endif
182    std::any context{&node};
183    try
184    {
185        // -server defaults to true for bitcoind but not for the GUI so do this here
186        args.SoftSetBoolArg("-server", true);
187        // Set this early so that parameter interactions go to console
188        InitLogging(args);
189        InitParameterInteraction(args);
190        if (!AppInitBasicSetup(args, node.exit_status)) {
191            // InitError will have been called with detailed error, which ends up on console
192            return false;
193        }
194        if (!AppInitParameterInteraction(args)) {
195            // InitError will have been called with detailed error, which ends up on console
196            return false;
197        }
198
199        node.warnings = std::make_unique<node::Warnings>();
200
201        node.kernel = std::make_unique<kernel::Context>();
202        node.ecc_context = std::make_unique<ECC_Context>();
203        if (!AppInitSanityChecks(*node.kernel))
204        {
205            // InitError will have been called with detailed error, which ends up on console
206            return false;
207        }
208
209        if (args.GetBoolArg("-daemon", DEFAULT_DAEMON) || args.GetBoolArg("-daemonwait", DEFAULT_DAEMONWAIT)) {
210#if HAVE_DECL_FORK
211            tfm::format(std::cout, CLIENT_NAME " starting\n");
212
213            // Daemonize
214            switch (fork_daemon(1, 0, daemon_ep)) { // don't chdir (1), do close FDs (0)
215            case 0: // Child: continue.
216                // If -daemonwait is not enabled, immediately send a success token the parent.
217                if (!args.GetBoolArg("-daemonwait", DEFAULT_DAEMONWAIT)) {
218                    daemon_ep.TokenWrite(1);
219                    daemon_ep.Close();
220                }
221                break;
222            case -1: // Error happened.
223                return InitError(Untranslated(strprintf("fork_daemon() failed: %s", SysErrorString(errno))));
224            default: { // Parent: wait and exit.
225                int token = daemon_ep.TokenRead();
226                if (token) { // Success
227                    exit(EXIT_SUCCESS);
228                } else { // fRet = false or token read error (premature exit).
229                    tfm::format(std::cerr, "Error during initialization - check %s for details\n", fs::PathToString(LogInstance().m_file_path.filename()));
230                    exit(EXIT_FAILURE);
231                }
232            }
233            }
234#else
235            return InitError(Untranslated("-daemon is not supported on this operating system"));
236#endif // HAVE_DECL_FORK
237        }
238        // Lock critical directories after daemonization
239        if (!AppInitLockDirectories())
240        {
241            // If locking a directory failed, exit immediately
242            return false;
243        }
244        fRet = AppInitInterfaces(node) && AppInitMain(node);
245    }
246    catch (const std::exception& e) {
247        PrintExceptionContinue(&e, "AppInit()");
248    } catch (...) {
249        PrintExceptionContinue(nullptr, "AppInit()");
250    }

src/wallet/receive.cpp

src/wallet/coinselection.cpp

src/consensus/validation.h

src/primitives/transaction.cpp

src/script/descriptor.cpp

src/bitcoin-cli.cpp

src/rpc/blockchain.cpp

src/rpc/rawtransaction.cpp

src/init.cpp

src/crypto/sha256.cpp

src/consensus/merkle.h

src/consensus/tx_check.h

src/consensus/tx_verify.h

src/policy/feerate.h

src/policy/feerate.cpp

src/primitives/transaction_identifier.h

src/chainparamsbase.h

src/chainparamsbase.cpp

src/util/moneystr.cpp

src/crypto/ripemd160.h

src/crypto/sha1.h

src/crypto/sha512.h

src/crypto/hmac_sha256.h

src/crypto/hmac_sha512.h

src/crypto/hmac_sha256.cpp

src/crypto/hmac_sha512.cpp

src/crypto/hkdf_sha256_32.h

src/crypto/hkdf_sha256_32.cpp

src/support/cleanse.h

src/support/cleanse.cpp

src/crypto/siphash.cpp

src/crypto/muhash.h

src/crypto/chacha20.h

src/crypto/poly1305.h

src/crypto/chacha20poly1305.h

src/crypto/chacha20poly1305.cpp

src/util/chaintype.cpp

src/util/obfuscation.h

src/util/byte_units.h

src/util/overflow.h

src/blockencodings.cpp

src/net_permissions.cpp

src/policy/packages.cpp

src/policy/rbf.cpp

src/policy/truc_policy.cpp

src/policy/ephemeral_policy.cpp

src/policy/settings.cpp

src/policy/policy.cpp

src/node/transaction.cpp

src/node/coin.cpp

src/rpc/client.cpp

src/rpc/external_signer.cpp

src/rpc/request.cpp

src/rpc/server_util.cpp

src/rpc/fees.cpp

src/rpc/output_script.cpp

src/rpc/rawtransaction_util.cpp

src/rpc/rawtransaction_util.h

src/rpc/register.h

src/rpc/request.h

src/rpc/server_util.h

src/rpc/protocol.h

src/rpc/server.h

src/rpc/signmessage.cpp

src/rpc/txoutproof.cpp

src/rpc/util.cpp

src/rpc/util.h

src/wallet/rpc/addresses.cpp

src/wallet/rpc/backup.cpp

src/wallet/rpc/coins.cpp

src/wallet/rpc/encrypt.cpp

src/wallet/rpc/signmessage.cpp

src/wallet/rpc/util.cpp

src/wallet/rpc/util.h

src/wallet/coincontrol.cpp

src/wallet/coincontrol.h

src/wallet/context.cpp

src/wallet/context.h

src/wallet/crypter.cpp

src/wallet/crypter.h

src/wallet/db.cpp

src/wallet/export.cpp

src/wallet/external_signer_scriptpubkeyman.cpp

src/wallet/rpc/spend.cpp

src/wallet/rpc/transactions.cpp

src/wallet/rpc/wallet.cpp

src/wallet/feebumper.cpp

src/wallet/feebumper.h

src/index/base.h

src/index/base.cpp

src/index/txindex.h

src/index/txindex.cpp

src/index/txindex_key.h

src/index/txospenderindex.h

src/index/txospenderindex.cpp

src/index/blockfilterindex.h

src/index/blockfilterindex.cpp

src/index/coinstatsindex.h

src/index/coinstatsindex.cpp

src/index/db_key.h

src/index/disktxpos.h

src/kernel/chain.cpp

src/kernel/chain.h

src/kernel/checks.cpp

src/kernel/checks.h

src/kernel/context.cpp

src/kernel/context.h

src/kernel/cs_main.cpp

src/kernel/cs_main.h

src/kernel/disconnected_transactions.cpp

src/kernel/disconnected_transactions.h

src/kernel/mempool_removal_reason.cpp

src/kernel/mempool_removal_reason.h

src/kernel/coinstats.cpp

src/kernel/coinstats.h

src/kernel/chainparams.cpp

src/kernel/chainparams.h

src/wallet/sqlite.cpp

src/wallet/sqlite.h

src/wallet/transaction.cpp

src/wallet/transaction.h

src/wallet/dump.cpp

src/wallet/dump.h

src/wallet/init.cpp

src/wallet/walletutil.cpp

src/wallet/walletutil.h

src/wallet/wallettool.cpp

src/wallet/wallettool.h

src/wallet/export.h

src/wallet/migrate.cpp

src/wallet/migrate.h

src/wallet/db.h

src/wallet/walletdb.cpp

src/wallet/interfaces.cpp

src/wallet/scriptpubkeyman.cpp

src/wallet/scriptpubkeyman.h

src/kernel/bitcoinkernel.cpp

src/kernel/bitcoinkernel.h

src/kernel/bitcoinkernel_wrapper.h

src/node/chainstate.cpp

src/node/chainstate.h

src/node/blockstorage.cpp

src/node/blockstorage.h

src/node/mempool_persist.cpp

src/node/mempool_persist.h

src/node/utxo_snapshot.cpp

src/node/utxo_snapshot.h

src/node/kernel_notifications.cpp

src/node/kernel_notifications.h

src/node/blockmanager_args.cpp

src/kernel/blockmanager_opts.h

src/util/expected.cpp

src/policy/settings.h

src/util/types.h

src/kernel/messagestartchars.h

src/kernel/warning.h

src/util/exception.h

src/common/license_info.h

src/node/coins_view_args.h

src/node/database_args.h

src/util/batchpriority.h

src/util/ui_change_type.h

src/node/coins_view_args.cpp

src/node/peerman_args.h

src/util/serfloat.h

src/node/blockmanager_args.h

src/node/database_args.cpp

src/util/overloaded.h

src/interfaces/types.h

src/node/chainstatemanager_args.h

src/node/minisketchwrapper.h

src/util/macros.h

src/util/syserror.h

src/common/run_command.h

src/util/bytevectorhash.cpp

src/node/mempool_persist_args.cpp

src/util/exec.h

src/util/rbf.h

src/crypto/hex_base.h

src/node/mempool_persist_args.h

src/interfaces/echo.h

src/util/any.h

src/util/batchpriority.cpp

src/util/threadnames.h

src/node/coin.h

src/node/mempool_args.h

src/util/asmap.h

src/util/bytevectorhash.h

src/node/context.cpp

src/util/insert.h

src/util/readwritefile.h

src/node/peerman_args.cpp

src/node/interface_ui.cpp

src/interfaces/handler.h

src/node/mining_args.h

src/util/hasher.cpp

src/common/init.h

src/kernel/mempool_limits.h

src/common/system.h

src/crypto/sha3.h

src/util/threadinterrupt.cpp

src/node/protocol_version.h

src/util/exception.cpp

src/common/messages.h

src/node/connection_types.cpp

src/util/bip32.h

src/common/license_info.cpp

src/util/stdmutex.h

src/common/run_command.cpp

src/util/check.cpp

src/util/golombrice.h

src/node/types.h

src/node/timeoffsets.h

src/util/readwritefile.cpp

src/util/fastrange.h

src/util/signalinterrupt.h

src/util/task_runner.h

src/util/syserror.cpp

src/common/interfaces.cpp

src/common/types.h

src/util/threadinterrupt.h

src/kernel/chainstatemanager_opts.h

src/node/psbt.h

src/policy/ephemeral_policy.h

src/util/trace.h

src/common/url.cpp

src/kernel/mempool_options.h

src/util/serfloat.cpp

src/kernel/notifications_interface.h

src/node/timeoffsets.cpp

src/node/warnings.cpp

src/util/hash_type.h

src/crypto/hex_base.cpp

src/node/eviction.h

src/util/tokenbucket.h

src/crypto/aes.h

src/common/pcp.h

src/util/feefrac.cpp

src/node/transaction.h

src/util/threadnames.cpp

src/common/signmessage.h

src/util/exec.cpp

src/util/signalinterrupt.cpp

Independent explanations by MyBitcoinExplorer. Not affiliated with or endorsed by Bitcoin Core. Guides are educational and do not replace the source or its tests.

Bitcoin Core source © its contributors, distributed under the MIT license. Original notices and bundled third-party licenses are retained in the source tree.