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

bitcoin / bitcoinstable

Find a file

▤ AddBoostIfNeeded.cmake

▤ AddWindowsResources.cmake

▤ CheckCXXFeatures.cmake

▤ CheckLinkerSupportsPIE.cmake

▤ CheckSourceCompilesWithFlags.cmake

▤ GetTargetInterface.cmake

▤ InstallBinaryComponent.cmake

▤ Maintenance.cmake

▤ ProcessConfigurations.cmake

▤ TargetDataSources.cmake

▤ TestAppendRequiredLibraries.cmake

▤ TryAppendCXXFlags.cmake

▤ TryAppendLinkerFlag.cmake

▤ WarnAboutGlobalProperties.cmake

script

▤ bitcoin-build-config.h.inGuide

▤ ccache.cmake

▤ crc32c.cmake

▤ introspection.cmake

▤ leveldb.cmake

▤ libmultiprocess.cmake

▤ minisketch.cmake

▤ secp256k1.cmake

▤ windows-app.manifest.in

▤ CMakeLists.txtGuide

▤ libbitcoinkernel.pc.in

bitcoin / cmake / module / TryAppendCXXFlags.cmake

Download source ↓

4,065 bytes · SHA-256 89915c7567e9911f… · View upstream ↗

1# Copyright (c) 2023-present The Bitcoin Core developers
2# Distributed under the MIT software license, see the accompanying
3# file COPYING or https://opensource.org/license/mit/.
4
5include_guard(GLOBAL)
6include(CheckCXXSourceCompiles)
7
8#[=[
9Add language-wide flags, which will be passed to all invocations of the compiler.
10This includes invocations that drive compiling and those that drive linking.
11
12Usage examples:
13
14  try_append_cxx_flags("-Wformat -Wformat-security" VAR warn_cxx_flags)
15
16
17  try_append_cxx_flags("-Wsuggest-override" VAR warn_cxx_flags
18    SOURCE "struct A { virtual void f(); }; struct B : A { void f() final; };"
19  )
20
21
22  try_append_cxx_flags("-fsanitize=${SANITIZERS}" TARGET core_interface
23    RESULT_VAR cxx_supports_sanitizers
24  )
25  if(NOT cxx_supports_sanitizers)
26    message(FATAL_ERROR "Compiler did not accept requested flags.")
27  endif()
28
29
30  try_append_cxx_flags("-Wunused-parameter" TARGET core_interface
31    IF_CHECK_PASSED "-Wno-unused-parameter"
32  )
33
34
35In configuration output, this function prints a string by the following pattern:
36
37  -- Performing Test CXX_SUPPORTS_[flags]
38  -- Performing Test CXX_SUPPORTS_[flags] - Success
39
40]=]
41function(try_append_cxx_flags flags)
42  cmake_parse_arguments(PARSE_ARGV 1
43    TACXXF                            # prefix
44    "SKIP_LINK"                       # options
45    "TARGET;VAR;SOURCE;RESULT_VAR"    # one_value_keywords
46    "IF_CHECK_PASSED"                 # multi_value_keywords
47  )
48
49  set(flags_as_string "${flags}")
50  separate_arguments(flags)
51
52  string(MAKE_C_IDENTIFIER "${flags_as_string}" id_string)
53  string(TOUPPER "${id_string}" id_string)
54
55  set(source "int main() { return 0; }")
56  if(DEFINED TACXXF_SOURCE AND NOT TACXXF_SOURCE STREQUAL source)
57    set(source "${TACXXF_SOURCE}")
58    string(SHA256 source_hash "${source}")
59    string(SUBSTRING ${source_hash} 0 4 source_hash_head)
60    string(APPEND id_string _${source_hash_head})
61  endif()
62
63  # This avoids running a linker.
64  set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)
65  set(CMAKE_REQUIRED_FLAGS "${flags_as_string} ${working_compiler_werror_flag}")
66  set(compiler_result CXX_SUPPORTS_${id_string})
67  check_cxx_source_compiles("${source}" ${compiler_result})
68
69  if(${compiler_result})
70    if(DEFINED TACXXF_IF_CHECK_PASSED)
71      if(DEFINED TACXXF_TARGET)
72        target_compile_options(${TACXXF_TARGET} INTERFACE ${TACXXF_IF_CHECK_PASSED})
73      endif()
74      if(DEFINED TACXXF_VAR)
75        list(JOIN TACXXF_IF_CHECK_PASSED " " flags_if_check_passed_as_string)
76        string(STRIP "${${TACXXF_VAR}} ${flags_if_check_passed_as_string}" ${TACXXF_VAR})
77      endif()
78    else()
79      if(DEFINED TACXXF_TARGET)
80        target_compile_options(${TACXXF_TARGET} INTERFACE ${flags})
81      endif()
82      if(DEFINED TACXXF_VAR)
83        string(STRIP "${${TACXXF_VAR}} ${flags_as_string}" ${TACXXF_VAR})
84      endif()
85    endif()
86  endif()
87
88  if(DEFINED TACXXF_VAR)
89    set(${TACXXF_VAR} "${${TACXXF_VAR}}" PARENT_SCOPE)
90  endif()
91
92  if(DEFINED TACXXF_RESULT_VAR)
93    set(${TACXXF_RESULT_VAR} "${${compiler_result}}" PARENT_SCOPE)
94  endif()
95
96  if(NOT ${compiler_result} OR TACXXF_SKIP_LINK)
97    return()
98  endif()
99
100  # This forces running a linker.
101  set(CMAKE_TRY_COMPILE_TARGET_TYPE EXECUTABLE)
102  set(CMAKE_REQUIRED_FLAGS "${flags_as_string}")
103  set(CMAKE_REQUIRED_LINK_OPTIONS ${working_linker_werror_flag})
104  set(linker_result LINKER_SUPPORTS_${id_string})
105  check_cxx_source_compiles("${source}" ${linker_result})
106
107  if(${linker_result})
108    if(DEFINED TACXXF_IF_CHECK_PASSED)
109      if(DEFINED TACXXF_TARGET)
110        target_link_options(${TACXXF_TARGET} INTERFACE ${TACXXF_IF_CHECK_PASSED})
111      endif()
112    else()
113      if(DEFINED TACXXF_TARGET)
114        target_link_options(${TACXXF_TARGET} INTERFACE ${flags})
115      endif()
116    endif()
117  else()
118    message(WARNING "'${flags_as_string}' fail(s) to link.")
119  endif()
120endfunction()
121
122if(MSVC)
123  try_append_cxx_flags("/WX /options:strict" VAR working_compiler_werror_flag SKIP_LINK)
124else()
125  try_append_cxx_flags("-Werror" VAR working_compiler_werror_flag SKIP_LINK)
126endif()
127

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.

340 guided files · 2,680 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

Code page 1

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.