2023-04-23 18:51:49 +02:00
OpenBSD build guide
======================
2017-10-03 04:15:55 +02:00
(updated for OpenBSD 6.2)
2023-04-23 18:51:49 +02:00
This guide describes how to build dashd and command-line utilities on OpenBSD.
2017-10-03 04:15:55 +02:00
OpenBSD is most commonly used as a server OS, so this guide does not contain instructions for building the GUI.
2023-04-23 18:51:49 +02:00
Preparation
-------------
Run the following as root to install the base dependencies for building:
```bash
2017-10-03 04:15:55 +02:00
pkg_add git gmake libevent libtool
2023-04-23 18:51:49 +02:00
pkg_add autoconf # (select highest version, e.g. 2.69)
pkg_add automake # (select highest version, e.g. 1.15)
2017-10-03 04:15:55 +02:00
pkg_add python # (select highest version, e.g. 3.6)
2023-05-27 19:45:04 +02:00
pkg_add gmp
2017-10-03 04:15:55 +02:00
pkg_add boost
git clone https://github.com/dashpay/dash.git
2023-04-23 18:51:49 +02:00
```
See [dependencies.md ](dependencies.md ) for a complete overview.
GCC
-------
2017-10-03 04:15:55 +02:00
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 Dash Core because it has no C++11 support. We'll install a newer version of GCC:
2023-04-23 18:51:49 +02:00
```bash
2017-10-03 04:15:55 +02:00
pkg_add g++
2023-04-23 18:51:49 +02:00
```
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` .
2017-10-03 04:15:55 +02:00
See "Berkeley DB" in [build-unix.md ](build-unix.md#berkeley-db ) for instructions on how to build BerkeleyDB 4.8.
2023-04-23 18:51:49 +02:00
You cannot use the BerkeleyDB library from ports, for the same reason as boost above (g++/libstd++ incompatibility).
```bash
# Pick some path to install BDB to, here we create a directory within the dash directory
BITCOIN_ROOT=$(pwd)
BDB_PREFIX="${BITCOIN_ROOT}/db4"
mkdir -p $BDB_PREFIX
# Fetch the source and verify that it is not tampered with
curl -o db-4.8.30.NC.tar.gz 'http://download.oracle.com/berkeley-db/db-4.8.30.NC.tar.gz'
echo '12edc0df75bf9abd7f82f821795bcee50f42cb2e5f76a6a281b85732798364ef db-4.8.30.NC.tar.gz' | sha256 -c
# MUST output: (SHA256) db-4.8.30.NC.tar.gz: OK
tar -xzf db-4.8.30.NC.tar.gz
# Build the library and install to specified prefix
cd db-4.8.30.NC/build_unix/
# Note: Do a static build so that it can be embedded into the executable, instead of having to find a .so at runtime
../dist/configure --enable-cxx --disable-shared --with-pic --prefix=$BDB_PREFIX CC=egcc CXX=eg++ CPP=ecpp
make install # do NOT use -jX, this is broken
```
### Resource limits
The standard ulimit restrictions in OpenBSD are very strict:
data(kbytes) 1572864
2017-10-03 04:15:55 +02:00
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 ](https://github.com/bitcoin/bitcoin/issues/6658 )).
2023-04-23 18:51:49 +02:00
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 Dash Core
**Important**: use `gmake` , not `make` . The non-GNU `make` will exit with a horrible error.
Preparation:
```bash
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
```
2017-10-03 04:15:55 +02:00
Make sure `BDB_PREFIX` is set to the appropriate path from the above steps.
2023-04-23 18:51:49 +02:00
To configure with wallet:
```bash
2017-10-03 04:15:55 +02:00
./configure --with-gui=no CC=egcc CXX=eg++ CPP=ecpp \
2023-04-23 18:51:49 +02:00
BDB_LIBS="-L${BDB_PREFIX}/lib -ldb_cxx-4.8" BDB_CFLAGS="-I${BDB_PREFIX}/include"
```
To configure without wallet:
```bash
2017-10-03 04:15:55 +02:00
./configure --disable-wallet --with-gui=no CC=egcc CXX=eg++ CPP=ecpp
2023-04-23 18:51:49 +02:00
```
Build and run the tests:
```bash
2017-10-03 04:15:55 +02:00
gmake # use -jX here for parallelism
2023-04-23 18:51:49 +02:00
gmake check
```
2017-10-03 04:15:55 +02:00
Clang
2023-04-23 18:51:49 +02:00
------------------------------
```bash
2017-10-03 04:15:55 +02:00
pkg_add llvm
2023-04-23 18:51:49 +02:00
./configure --disable-wallet --with-gui=no CC=clang CXX=clang++
2017-10-03 04:15:55 +02:00
gmake # use -jX here for parallelism
gmake check
2023-04-23 18:51:49 +02:00
```