af9103eb75
Instead of maintaining not-easily-tested instructions for building BerkeleyDB in doc/build-unix.md, package the installation as a script in contrib/. This allows shared usage from a number of contexts, e.g. Docker. Thanks to @jonasschnelli, @laanwj for feedback.
3.1 KiB
OpenBSD build guide
(updated for OpenBSD 6.2)
This guide describes how to build bitcoind and command-line utilities on OpenBSD.
OpenBSD is most commonly used as a server OS, so this guide does not contain instructions for building the GUI.
Preparation
Run the following as root to install the base dependencies for building:
pkg_add git gmake libevent libtool
pkg_add autoconf # (select highest version, e.g. 2.69)
pkg_add automake # (select highest version, e.g. 1.15)
pkg_add python # (select highest version, e.g. 3.6)
pkg_add boost
git clone https://github.com/bitcoin/bitcoin.git
See dependencies.md for a complete overview.
GCC
The default C++ compiler that comes with OpenBSD 6.2 is g++ 4.2.1. This version is old (from 2007), and is not able to compile the current version of Bitcoin Core because it has no C++11 support. We'll install a newer version of GCC:
pkg_add g++
This compiler will not overwrite the system compiler, it will be installed as egcc and eg++ in /usr/local/bin.
Building BerkeleyDB
BerkeleyDB is only necessary for the wallet functionality. To skip this, pass --disable-wallet to ./configure.
It is recommended to use Berkeley DB 4.8. You cannot use the BerkeleyDB library from ports, for the same reason as boost above (g++/libstd++ incompatibility). If you have to build it yourself, you can use the installation script included in contrib/ like so
./contrib/install_db4.sh `pwd` CC=egcc CXX=eg++ CPP=ecpp
from the root of the repository.
Resource limits
The standard ulimit restrictions in OpenBSD are very strict:
data(kbytes) 1572864
This, unfortunately, may no longer be enough to compile some .cpp files in the project,
at least with GCC 4.9.4 (see issue #6658).
If your user is in the staff group the limit can be raised with:
ulimit -d 3000000
The change will only affect the current shell and processes spawned by it. To
make the change system-wide, change datasize-cur and datasize-max in
/etc/login.conf, and reboot.
Building Bitcoin Core
Important: use gmake, not make. The non-GNU make will exit with a horrible error.
Preparation:
export AUTOCONF_VERSION=2.69 # replace this with the autoconf version that you installed
export AUTOMAKE_VERSION=1.15 # replace this with the automake version that you installed
./autogen.sh
Make sure BDB_PREFIX is set to the appropriate path from the above steps.
To configure with wallet:
./configure --with-gui=no CC=egcc CXX=eg++ CPP=ecpp \
BDB_LIBS="-L${BDB_PREFIX}/lib -ldb_cxx-4.8" BDB_CFLAGS="-I${BDB_PREFIX}/include"
To configure without wallet:
./configure --disable-wallet --with-gui=no CC=egcc CXX=eg++ CPP=ecpp
Build and run the tests:
gmake # use -jX here for parallelism
gmake check
Clang
pkg_add llvm
./configure --disable-wallet --with-gui=no CC=clang CXX=clang++
gmake # use -jX here for parallelism
gmake check