BITCOIN MAINNETLive explorer status

Explorer Mempool Feed Forum Visualizer Receipts Tools Learn Code

Inside Bitcoin

Opening the selected file…

₿MyBitcoinExplorer

Bitcoin, in focus.
Explore the network. Understand the connections.

Explore Bitcoin with clarity.

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

bitcoin / bitcoinstable

Find a file

▤ batchpriority.cppGuide

▤ batchpriority.hGuide

▤ bytevectorhash.cppGuide

▤ bytevectorhash.hGuide

▤ readwritefile.cppGuide

▤ readwritefile.hGuide

▤ result.hGuide

▤ serfloat.cppGuide

▤ serfloat.hGuide

▤ signalinterrupt.cppGuide

▤ signalinterrupt.hGuide

▤ threadinterrupt.cppGuide

▤ threadinterrupt.hGuide

▤ threadnames.cppGuide

▤ ui_change_type.hGuide

▤ arith_uint256.hGuide

▤ bitcoin-chainstate.cpp

▤ bitcoin-cli-res.rc

▤ bitcoin-cli.cppGuide

▤ bitcoin-res.rc

▤ bitcoin-tx-res.rc

▤ bitcoin-tx.cpp

▤ bitcoin-util-res.rc

▤ bitcoin-util.cpp

▤ bitcoin-wallet-res.rc

▤ blockencodings.cppGuide

▤ blockencodings.hGuide

▤ blockfilter.cppGuide

▤ blockfilter.hGuide

▤ chain.cppGuide

▤ chain.h

▤ chainparams.cppGuide

▤ chainparams.hGuide

▤ chainparamsbase.cppGuide

▤ chainparamsbase.hGuide

▤ chainparamsseeds.h

▤ checkqueue.hGuide

▤ clientversion.cppGuide

▤ clientversion.hGuide

▤ cluster_linearize.h

▤ CMakeLists.txt

▤ coins.cppGuide

▤ coins.hGuide

▤ compressor.cppGuide

▤ compressor.hGuide

▤ core_io.cpp

▤ core_io.hGuide

▤ core_memusage.hGuide

▤ cuckoocache.h

▤ dbwrapper.cpp

▤ dbwrapper.hGuide

▤ deploymentinfo.cppGuide

▤ deploymentinfo.hGuide

▤ deploymentstatus.cppGuide

▤ deploymentstatus.hGuide

▤ dummywallet.cppGuide

▤ external_signer.cpp

▤ external_signer.hGuide

▤ merkleblock.cppGuide

▤ merkleblock.hGuide

▤ musig.cpp

▤ musig.hGuide

▤ net_permissions.cppGuide

▤ net_permissions.hGuide

▤ net_processing.cppGuide

▤ netaddress.cppGuide

▤ netmessagemaker.hGuide

▤ noui.cppGuide

▤ noui.hGuide

▤ outputtype.cppGuide

▤ private_broadcast.cpp

▤ private_broadcast.h

▤ semaphore_grant.hGuide

▤ threadsafety.hGuide

▤ tinyformat.h

▤ torcontrol.cppGuide

▤ validation.cppGuide

▤ validation.h

▤ validationinterface.cpp

▤ validationinterface.h

▤ versionbits_impl.hGuide

▤ versionbits.cpp

▤ versionbits.hGuide

▤ walletinitinterface.hGuide

▤ CMakeLists.txtGuide

▤ libbitcoinkernel.pc.in

bitcoin / src / util / subprocess.h

Download source ↓

41,142 bytes · SHA-256 78bbc2ce46fb71d9… · View upstream ↗

1001  void execute_process() noexcept(false);
1002
1003private:
1004  detail::Streams stream_;
1005
1006#ifdef WIN32
1007  HANDLE process_handle_;
1008  std::future<void> cleanup_future_;
1009#else
1010  // Pid of the child process
1011  int child_pid_ = -1;
1012#endif
1013
1014  std::string exe_name_;
1015
1016  // Command provided as sequence
1017  std::vector<std::string> vargs_;
1018  std::vector<char*> cargv_;
1019
1020  int retcode_ = -1;
1021};
1022
1023inline void Popen::init_args() {
1024  populate_c_argv();
1025}
1026
1027template <typename F, typename... Args>
1028inline void Popen::init_args(F&& farg, Args&&... args)
1029{
1030  detail::ArgumentDeducer argd(this);
1031  argd.set_option(std::forward<F>(farg));
1032  init_args(std::forward<Args>(args)...);
1033}
1034
1035inline void Popen::populate_c_argv()
1036{
1037  cargv_.clear();
1038  cargv_.reserve(vargs_.size() + 1);
1039  for (auto& arg : vargs_) cargv_.push_back(&arg[0]);
1040  cargv_.push_back(nullptr);
1041}
1042
1043inline int Popen::wait() noexcept(false)
1044{
1045#ifdef WIN32
1046  int ret = WaitForSingleObject(process_handle_, INFINITE);
1047
1048  // WaitForSingleObject with INFINITE should only return when process has signaled
1049  if (ret != WAIT_OBJECT_0) {
1050    throw OSError("Unexpected return code from WaitForSingleObject", 0);
1051  }
1052
1053  DWORD dretcode_;
1054
1055  if (FALSE == GetExitCodeProcess(process_handle_, &dretcode_))
1056      throw OSError("Failed during call to GetExitCodeProcess", 0);
1057
1058  CloseHandle(process_handle_);
1059
1060  return (int)dretcode_;
1061#else
1062  int ret, status;
1063  std::tie(ret, status) = util::wait_for_child_exit(child_pid_);
1064  if (ret == -1) {
1065    if (errno != ECHILD) throw OSError("waitpid failed", errno);
1066    return 0;
1067  }
1068  if (WIFEXITED(status)) return WEXITSTATUS(status);
1069  if (WIFSIGNALED(status)) return WTERMSIG(status);
1070  else return 255;
1071
1072  return 0;
1073#endif
1074}
1075
1076inline void Popen::execute_process() noexcept(false)
1077{
1078#ifdef WIN32
1079  if (exe_name_.length()) {
1080    this->vargs_.insert(this->vargs_.begin(), this->exe_name_);
1081    this->populate_c_argv();
1082  }
1083  this->exe_name_ = vargs_[0];
1084
1085  std::string argument;
1086  std::string command_line;
1087  bool first_arg = true;
1088
1089  for (auto arg : this->vargs_) {
1090    if (!first_arg) {
1091      command_line += " ";
1092    } else {
1093      first_arg = false;
1094    }
1095    argument = arg;
1096    util::quote_argument(argument, command_line, /*force=*/false);
1097  }
1098
1099  // CreateProcessA can modify szCmdLine so we allocate needed memory
1100  char *szCmdline = new char[command_line.size() + 1];
1101  strcpy_s(szCmdline, command_line.size() + 1, command_line.c_str());
1102  PROCESS_INFORMATION piProcInfo;
1103  STARTUPINFOA siStartInfo;
1104  BOOL bSuccess = FALSE;
1105  DWORD creation_flags = CREATE_NO_WINDOW;
1106
1107  // Set up members of the PROCESS_INFORMATION structure.
1108  ZeroMemory(&piProcInfo, sizeof(PROCESS_INFORMATION));
1109
1110  // Set up members of the STARTUPINFOA structure.
1111  // This structure specifies the STDIN and STDOUT handles for redirection.
1112
1113  ZeroMemory(&siStartInfo, sizeof(STARTUPINFOA));
1114  siStartInfo.cb = sizeof(STARTUPINFOA);
1115
1116  siStartInfo.hStdError = this->stream_.g_hChildStd_ERR_Wr;
1117  siStartInfo.hStdOutput = this->stream_.g_hChildStd_OUT_Wr;
1118  siStartInfo.hStdInput = this->stream_.g_hChildStd_IN_Rd;
1119
1120  siStartInfo.dwFlags |= STARTF_USESTDHANDLES;
1121
1122  // Create the child process.
1123  bSuccess = CreateProcessA(NULL,
1124                            szCmdline,    // command line
1125                            NULL,         // process security attributes
1126                            NULL,         // primary thread security attributes
1127                            TRUE,         // handles are inherited
1128                            creation_flags, // creation flags
1129                            NULL,         // use parent's environment
1130                            NULL,         // use parent's current directory
1131                            &siStartInfo, // STARTUPINFOA pointer
1132                            &piProcInfo); // receives PROCESS_INFORMATION
1133
1134  // If an error occurs, exit the application.
1135  if (!bSuccess) {
1136    DWORD errorMessageID = ::GetLastError();
1137    throw CalledProcessError("CreateProcess failed: " + util::get_last_error(errorMessageID), errorMessageID);
1138  }
1139
1140  CloseHandle(piProcInfo.hThread);
1141
1142  /*
1143    TODO: use common apis to close linux handles
1144  */
1145
1146  this->process_handle_ = piProcInfo.hProcess;
1147
1148  this->cleanup_future_ = std::async(std::launch::async, [this] {
1149    WaitForSingleObject(this->process_handle_, INFINITE);
1150
1151    CloseHandle(this->stream_.g_hChildStd_ERR_Wr);
1152    CloseHandle(this->stream_.g_hChildStd_OUT_Wr);
1153    CloseHandle(this->stream_.g_hChildStd_IN_Rd);
1154  });
1155
1156/*
1157  NOTE: In the linux version, there is a check to make sure that the process
1158        has been started. Here, we do nothing because CreateProcess will throw
1159        if we fail to create the process.
1160*/
1161
1162
1163#else
1164
1165  int err_rd_pipe, err_wr_pipe;
1166  std::tie(err_rd_pipe, err_wr_pipe) = util::pipe_cloexec();
1167
1168  if (exe_name_.length()) {
1169    vargs_.insert(vargs_.begin(), exe_name_);
1170    populate_c_argv();
1171  }
1172  exe_name_ = vargs_[0];
1173
1174  child_pid_ = fork();
1175
1176  if (child_pid_ < 0) {
1177    subprocess_close(err_rd_pipe);
1178    subprocess_close(err_wr_pipe);
1179    throw OSError("fork failed", errno);
1180  }
1181
1182  if (child_pid_ == 0)
1183  {
1184    // Close descriptors belonging to parent
1185    stream_.close_parent_fds();
1186
1187    //Close the read end of the error pipe
1188    subprocess_close(err_rd_pipe);
1189
1190    detail::Child chld(this, err_wr_pipe);
1191    chld.execute_child();
1192  }
1193  else
1194  {
1195    subprocess_close(err_wr_pipe);// close child side of pipe, else get stuck in read below
1196
1197    stream_.close_child_fds();
1198
1199    try {
1200      char err_buf[SP_MAX_ERR_BUF_SIZ] = {0,};
1201
1202      FILE* err_fp = fdopen(err_rd_pipe, "r");
1203      if (!err_fp) {
1204          subprocess_close(err_rd_pipe);
1205          throw OSError("fdopen failed", errno);
1206      }
1207      int read_bytes = util::read_atmost_n(err_fp, err_buf, SP_MAX_ERR_BUF_SIZ);
1208      fclose(err_fp);
1209
1210      if (read_bytes || strlen(err_buf)) {
1211        // Call waitpid to reap the child process
1212        // waitpid suspends the calling process until the
1213        // child terminates.
1214        int retcode = wait();
1215
1216        // Throw whatever information we have about child failure
1217        throw CalledProcessError(err_buf, retcode);
1218      }
1219    } catch (std::exception& exp) {
1220      stream_.cleanup_fds();
1221      throw;
1222    }
1223
1224  }
1225#endif
1226}
1227
1228namespace detail {
1229
1230  inline void ArgumentDeducer::set_option(executable&& exe) {
1231    popen_->exe_name_ = std::move(exe.arg_value);
1232  }
1233
1234  inline void ArgumentDeducer::set_option(input&& inp) {
1235    if (inp.rd_ch_ != -1) popen_->stream_.read_from_parent_ = inp.rd_ch_;
1236    if (inp.wr_ch_ != -1) popen_->stream_.write_to_child_ = inp.wr_ch_;
1237  }
1238
1239  inline void ArgumentDeducer::set_option(output&& out) {
1240    if (out.wr_ch_ != -1) popen_->stream_.write_to_parent_ = out.wr_ch_;
1241    if (out.rd_ch_ != -1) popen_->stream_.read_from_child_ = out.rd_ch_;
1242  }
1243
1244  inline void ArgumentDeducer::set_option(error&& err) {
1245    if (err.deferred_) {
1246      if (popen_->stream_.write_to_parent_) {
1247        popen_->stream_.err_write_ = popen_->stream_.write_to_parent_;
1248      } else {
1249        throw std::runtime_error("Set output before redirecting error to output");
1250      }

A READING COMPANION

Source available. Guide coming next.

This file is included in the stable source snapshot. A file-specific guide has not been published yet.

440 guided files · 2,580 pending. Guides cover key sections, not every line.

cmake/bitcoin-build-config.h.in src/consensus/amount.h src/consensus/consensus.h src/primitives/block.h src/primitives/transaction.h src/crypto/sha256.h src/util/moneystr.h src/clientversion.h src/uint256.h src/script/script.h src/policy/policy.h CMakeLists.txt README.md COPYING src/consensus/tx_check.cpp src/consensus/tx_verify.cpp src/consensus/merkle.cpp src/pow.cpp src/validation.cpp src/script/interpreter.cpp src/script/solver.cpp src/script/sign.cpp src/key_io.cpp src/net.cpp src/net_processing.cpp src/netaddress.cpp src/protocol.h src/wallet/wallet.cpp src/wallet/spend.cpp

← Previous 250 linesCode page 5Next 250 lines →

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

src/clientversion.cpp

src/common/signmessage.cpp

src/compat/assumptions.h

src/compat/byteswap.h

src/deploymentinfo.cpp

src/deploymentinfo.h

src/deploymentstatus.cpp

src/deploymentstatus.h

src/dummywallet.cpp

src/external_signer.h

src/init/bitcoin-gui.cpp

src/init/bitcoin-node.cpp

src/init/bitcoin-qt.cpp

src/init/bitcoin-wallet.cpp

src/init/bitcoind.cpp

src/init/common.h

src/interfaces/init.h

src/interfaces/ipc.h

src/key_io.h

src/logging/categories.h

src/logging/timer.h

src/mapport.h

src/musig.h

src/net_permissions.h

src/netgroup.h

src/netmessagemaker.h

src/node/chainstatemanager_args.cpp

src/node/connection_types.h

src/node/context.h

src/node/interface_ui.h

src/node/mempool_args.cpp

src/node/mining_args.cpp

src/node/minisketchwrapper.cpp

src/node/txreconciliation.h

src/policy/fees/estimator_args.cpp

src/policy/fees/estimator_args.h

src/policy/fees/estimator_man.cpp

src/policy/fees/estimator_man.h

src/policy/packages.h

src/policy/rbf.h

src/policy/truc_policy.h

src/pow.h

src/primitives/block.cpp

src/randomenv.h

src/rest.h

src/script/keyorigin.h

src/script/parsing.cpp

src/script/parsing.h

src/script/script_error.h

src/script/sigcache.cpp

src/script/sigcache.h

src/script/solver.h

src/script/verify_flags.h

src/semaphore_grant.h

src/signet.h

src/span.h

src/support/allocators/secure.h

src/support/allocators/zeroafterfree.h

src/util/tokenpipe.cpp

src/util/translation.h

src/util/vector.h

src/versionbits.h

src/versionbits_impl.h

src/wallet/external_signer_scriptpubkeyman.h

src/wallet/fees.h

src/wallet/load.h

src/wallet/receive.h

src/wallet/rpc/wallet.h

src/wallet/types.h

src/walletinitinterface.h

src/zmq/zmqabstractnotifier.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.