Build:OpenBSD

From Genesis Network Wiki
Jump to navigation Jump to search

Return to Developer's Guide

Some contributions to this Wiki comes from the team at Bitcoin Core

OpenBSD Build Instructions

(updated for OpenBSD 6.2)

This guide describes how to build genesisd 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:

bash
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/genesisofficial/genesis.git

Note

From OpenBSD 6.2 onwards a C++11-supporting clang compiler is part of the base image, and while building it is necessary to make sure that this compiler is used and not ancient g++ 4.2.1. This is done by appending `CC=cc CXX=c++` to configuration commands. Mixing different compilers within the same executable will result in linker errors.

Building BerkeleyDB

BerkeleyDB is only necessary for the wallet functionality. To skip this, pass `--disable-wallet` to `./configure` and skip to the next section.

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, perform the following:

shell
./contrib/install_db4.sh `pwd` CC=cc CXX=c++

from the root of the repository. Then set `BDB_PREFIX` for the next section:

shell
export BDB_PREFIX="$PWD/db4"

Building Genesis

Note

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

Make sure `BDB_PREFIX` is set to the appropriate path from the above steps.

Configuration for Wallet

bash
./configure --with-gui=no CC=cc CXX=c++ \
BDB_LIBS="-L${BDB_PREFIX}/lib -ldb_cxx-4.8" BDB_CFLAGS="-I${BDB_PREFIX}/include"

Configuration without Wallet

bash
./configure --disable-wallet --with-gui=no CC=cc CXX=c++

Build and Run Tests

bash
gmake # use -jX here for parallelism
gmake check

Resource Limits

If the build runs into out-of-memory errors, the instructions in this section might help.

The standard ulimit restrictions in OpenBSD are very strict:

data(kbytes)         1572864

This, unfortunately, in some cases not enough to compile some `.cpp` files in the project. 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.