git / moonbite-core / doc/build-openbsd.md · raw

OpenBSD build guide======================(updated for OpenBSD 6.7)This guide describes how to build litecoind, litecoin-qt, and command-line utilities on OpenBSD.Preparation-------------Run the following as root to install the base dependencies for building:```bashpkg_add git gmake libevent libtool boostpkg_add qt5 # (optional for enabling the GUI)pkg_add autoconf # (select highest version, e.g. 2.69)pkg_add automake # (select highest version, e.g. 1.16)pkg_add python # (select highest version, e.g. 3.8)git clone https://github.com/litecoin-project/litecoin.git```See [dependencies.md](dependencies.md) for a complete overview.**Important**: From OpenBSD 6.2 onwards a C++11-supporting clang compiler ispart of the base image, and while building it is necessary to make sure thatthis compiler is used and not ancient g++ 4.2.1. This is done by appending`CC=cc CC_FOR_BUILD=cc CXX=c++` to configuration commands. Mixing differentcompilers within the same executable will result in errors.### Building BerkeleyDBBerkeleyDB 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 libraryfrom ports, for the same reason as boost above (g++/libstd++ incompatibility).If you have to build it yourself, you can use [the installation script includedin contrib/](/contrib/install_db4.sh) like so:```bash./contrib/install_db4.sh `pwd` CC=cc CXX=c++```from the root of the repository. Then set `BDB_PREFIX` for the next section:```bashexport BDB_PREFIX="$PWD/db4"```### Building Litecoin Core**Important**: Use `gmake` (the non-GNU `make` will exit with an error).Preparation:```bash# Replace this with the autoconf version that you installed. Include only# the major and minor parts of the version: use "2.69" for "autoconf-2.69p2".export AUTOCONF_VERSION=2.69# Replace this with the automake version that you installed. Include only# the major and minor parts of the version: use "1.16" for "automake-1.16.1".export AUTOMAKE_VERSION=1.16./autogen.sh```Make sure `BDB_PREFIX` is set to the appropriate path from the above steps.To configure with 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" \    MAKE=gmake```To configure without wallet:```bash./configure --disable-wallet --with-gui=no CC=cc CC_FOR_BUILD=cc CXX=c++ MAKE=gmake```To configure with GUI:```bash./configure --with-gui=yes CC=cc CXX=c++ \    BDB_LIBS="-L${BDB_PREFIX}/lib -ldb_cxx-4.8" \    BDB_CFLAGS="-I${BDB_PREFIX}/include" \    MAKE=gmake```Build and run the tests:```bashgmake # use -jX here for parallelismgmake check```Resource limits-------------------If the build runs into out-of-memory errors, the instructions in this sectionmight help.The standard ulimit restrictions in OpenBSD are very strict:    data(kbytes)         1572864This is, unfortunately, in some cases not enough to compile some `.cpp` files in the project,(see issue [#6658](https://github.com/bitcoin/bitcoin/issues/6658)).If your user is in the `staff` group the limit can be raised with:    ulimit -d 3000000The change will only affect the current shell and processes spawned by it. Tomake the change system-wide, change `datasize-cur` and `datasize-max` in`/etc/login.conf`, and reboot.