mirror of
https://github.com/dashpay/dash.git
synced 2024-12-25 12:02:48 +01:00
0e2e315fcc
07bc22ef105dee3c6c465a3ef31e52fd198e786d docs: improve make with parallel jobs description. (Klement Tan)
Pull request description:
Changed `use -jX here for parallelism` to `use "-j N" for N parallel jobs`
**Rationale**: In my opinion `use -jX here for parallelism` is quite ambiguous as it could be perceived as a single option without any argument. Ie running:
```sh
make -jX
```
Embarrassingly this caused me to be stuck for quite a long time until I opened the help menu for `make` but if I am the only one who faced this issue I would be happy to close this PR.
ACKs for top commit:
jarolrod:
ACK 07bc22ef105dee3c6c465a3ef31e52fd198e786d
Tree-SHA512: 2d119b6a461668906c63184b865d2cc9fb2f75abeba34e2e44bc1ef3bcb4adec4a49896ddaf3cc6a20c0095ad20d0de0908401b351eaca9443161d24d6b20d0b
112 lines
3.2 KiB
Markdown
112 lines
3.2 KiB
Markdown
OpenBSD build guide
|
|
======================
|
|
(updated for OpenBSD 6.7)
|
|
|
|
This guide describes how to build dashd, dash-qt, and command-line utilities on OpenBSD.
|
|
|
|
Preparation
|
|
-------------
|
|
|
|
Run the following as root to install the base dependencies for building:
|
|
|
|
```bash
|
|
pkg_add git gmake libevent libtool
|
|
pkg_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.15)
|
|
pkg_add python # (select highest version, e.g. 3.8)
|
|
pkg_add gmp
|
|
pkg_add bash
|
|
pkg_add boost
|
|
|
|
git clone https://github.com/dashpay/dash.git
|
|
```
|
|
|
|
See [dependencies.md](dependencies.md) for a complete overview.
|
|
|
|
**Important**: 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 CC_FOR_BUILD=cc CXX=c++` to configuration commands. Mixing different
|
|
compilers within the same executable will result in 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, you can use [the installation script included
|
|
in 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:
|
|
|
|
```bash
|
|
export BDB_PREFIX="$PWD/db4"
|
|
```
|
|
|
|
### Building Dash Core
|
|
|
|
**Important**: Use `gmake` (the non-GNU `make` will exit with an 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.
|
|
|
|
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:
|
|
```bash
|
|
gmake # use "-j N" here for N parallel jobs
|
|
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,
|
|
(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 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.
|
|
|