doc: update FreeBSD build guide for 12.0

This commit is contained in:
fanquake 2019-02-15 19:54:59 +08:00
parent c576979b78
commit 901baf2c9e
No known key found for this signature in database
GPG key ID: 2EEB9F5CC09526C1

View file

@ -1,6 +1,6 @@
FreeBSD build guide FreeBSD build guide
====================== ======================
(updated for FreeBSD 11.1) (updated for FreeBSD 12.0)
This guide describes how to build bitcoind and command-line utilities on FreeBSD. This guide describes how to build bitcoind and command-line utilities on FreeBSD.
@ -10,55 +10,51 @@ This guide does not contain instructions for building the GUI.
You will need the following dependencies, which can be installed as root via pkg: You will need the following dependencies, which can be installed as root via pkg:
``` ```shell
pkg install autoconf automake boost-libs git gmake libevent libtool openssl pkgconf pkg install autoconf automake boost-libs git gmake libevent libtool openssl pkgconf
git clone https://github.com/bitcoin/bitcoin.git
``` ```
In order to run the test suite (recommended), you will need to have Python 3 installed: In order to run the test suite (recommended), you will need to have Python 3 installed:
``` ```shell
pkg install python3 pkg install python3
``` ```
For the wallet (optional):
```
./contrib/install_db4.sh `pwd`
export BDB_PREFIX="$PWD/db4"
```
See [dependencies.md](dependencies.md) for a complete overview. See [dependencies.md](dependencies.md) for a complete overview.
Download the source code: ### Building BerkeleyDB
```
git clone https://github.com/bitcoin/bitcoin BerkeleyDB is only necessary for the wallet functionality. To skip this, pass
`--disable-wallet` to `./configure` and skip to the next section.
```shell
./contrib/install_db4.sh `pwd`
export BDB_PREFIX="$PWD/db4"
``` ```
## Building Bitcoin Core ## Building Bitcoin Core
**Important**: Use `gmake` (the non-GNU `make` will exit with an error): **Important**: Use `gmake` (the non-GNU `make` will exit with an error):
``` With wallet:
```shell
./autogen.sh ./autogen.sh
./configure --with-gui=no \
./configure # to build with wallet OR BDB_LIBS="-L${BDB_PREFIX}/lib -ldb_cxx-4.8" \
./configure --disable-wallet # to build without wallet BDB_CFLAGS="-I${BDB_PREFIX}/include"
``` ```
followed by either: Without wallet:
```shell
``` ./autogen.sh
gmake ./configure --with-gui=no --disable-wallet
``` ```
to build without testing, or followed by:
```shell
gmake # use -jX here for parallelism
gmake check # Run tests if Python 3 is available
``` ```
gmake check
```
to also run the test suite (recommended, if Python 3 is installed).
*Note on debugging*: The version of `gdb` installed by default is [ancient and considered harmful](https://wiki.freebsd.org/GdbRetirement).
It is not suitable for debugging a multi-threaded C++ program, not even for getting backtraces. Please install the package `gdb` and
use the versioned gdb command (e.g. `gdb7111`).