UNIX BUILD NOTES
Some notes on how to build Bitcoin Cash Node in Unix.
- For Ubuntu & Debian specific instructions, see build-unix-deb.md in this directory.
- For Fedora & CentOS specific instructions, see build-unix-rpm.md in this directory.
- For Arch Linux specific instructions, see build-unix-arch.md in this directory.
- For FreeBSD specific instructions, see build-freebsd.md in this directory.
Table of contents
- UNIX BUILD NOTES
- To Build
To build Bitcoin Cash Node you first need to install all the needed dependencies. See dependencies.md or your OS specific guide in build-*.md. If you wish to compile the dependencies from source yourself, please see instructions in depends.
Please make sure that your compiler supports C++14.
Assuming you have all the necessary dependencies installed the commands below will
build the node, with the
bitcoin-qt GUI-client as well.
git clone https://gitlab.com/bitcoin-cash-node/bitcoin-cash-node.git cd bitcoin-cash-node/ mkdir build cd build cmake -GNinja .. ninja ninja check # recommended
After a successful test you can install the newly built binaries to your bin directory.
Note that this will probably overwrite any previous version installed, including binaries from different sources.
It might be necessary to run with
sudo, depending on your system configuration:
ninja install #optional
When the intention is to run only a P2P node without a wallet, Bitcoin Cash Node
may be compiled in disable-wallet mode by passing
cmake command line.
Mining is also possible in disable-wallet mode using the
getblocktemplate RPC call.
These steps can be performed on, for example, a Debian VM. The depends system will also work on other Linux distributions, however the commands for installing the toolchain will be different.
Make sure you install all the build requirements mentioned above. Then, install the toolchain and some additional dependencies:
sudo apt-get install autoconf automake curl g++-arm-linux-gnueabihf gcc-arm-linux-gnueabihf gperf pkg-config libtool
To build executables for ARM:
cd depends make build-linux-arm cd .. mkdir build cd build cmake -GNinja .. -DCMAKE_TOOLCHAIN_FILE=../cmake/platforms/LinuxARM.cmake -DENABLE_GLIBC_BACK_COMPAT=ON -DENABLE_STATIC_LIBSTDCXX=ON ninja ninja check # recommended
For further documentation on the depends system see README.md in the depends directory.
Additional cmake options
A list of the cmake options and their current value can be displayed.
From the build subdirectory (see above), run
cmake -LH ...
C++ compilers are memory-hungry. It is recommended to have at least 1.5 GB of memory available when compiling Bitcoin Cash Node. On systems with less, gcc can be tuned to conserve memory with additional CXXFLAGS:
cmake -GNinja -DCXXFLAGS="--param ggc-min-expand=1 --param ggc-min-heapsize=32768" ..
Strip debug symbols
The release is built with GCC and then
strip bitcoind to strip the debug
symbols, which reduces the executable size by about 90%.
ENABLE_UPNP Enable UPnP support (miniupnp required, default ON) START_WITH_UPNP UPnP support turned on by default at runtime (default OFF)
To help make your Bitcoin Cash Node installation more secure by making certain
attacks impossible to exploit even if a vulnerability is found, binaries are hardened by default.
This can be disabled by passing
Hardening enables the following features:
Position Independent Executable: Build position independent code to take advantage of Address Space Layout Randomization offered by some kernels. Attackers who can cause execution of code at an arbitrary memory location are thwarted if they don't know where anything useful is located. The stack and heap are randomly located by default, but this allows the code section to be randomly located as well.
On an AMD64 processor where a library was not compiled with -fPIC, this will cause an error such as: "relocation R_X86_64_32 against `......' can not be used when making a shared object;"
To test that you have built PIE executable, install
scanelf, part of
pax-utils, and use:
scanelf -e ./bitcoin
The output should contain:
Non-executable Stack: If the stack is executable then trivial stack-based buffer overflow exploits are possible if vulnerable buffers are found. By default, Bitcoin Cash Node should be built with a non-executable stack, but if one of the libraries it uses asks for an executable stack or someone makes a mistake and uses a compiler extension which requires an executable stack, it will silently build an executable without the non-executable stack protection.
To verify that the stack is non-executable after compiling use:
scanelf -e ./bitcoin
The output should contain:
STK/REL/PTL RW- R-- RW-
The `STK RW-` means that the stack is readable and writeable but not executable.