mirror of https://github.com/bitcoin/bitcoin.git synced 2026-09-11 21:20:39 +02:00

Files

merge-script 17c5e33e9c Merge bitcoin/bitcoin#35216 : qa: Improve functional test support on illumos and *BSD

f4a6d079c4 qa: Support `get_bind_addrs` and `feature_bind_extra` on illumos (Hennadii Stepanov)
5e96a8fd5a doc: Add `lsof` to Test Suite Dependencies on NetBSD (Hennadii Stepanov)
5d01aa4772 qa: Ignore `lsof` warnings on NetBSD (Hennadii Stepanov)
70352fda03 qa: Strip prefix length from NetBSD `ifconfig` output (Hennadii Stepanov)
1c1735567e doc: Add `lsof` to Test Suite Dependencies on FreeBSD (Hennadii Stepanov)
4cb7f39c2c qa: Drop OpenBSD from supported platforms in `get_bind_addrs` function (Hennadii Stepanov)
8a982eea85 qa: Add `skip_if_no_lsof_on_nonlinux` helper and use it where needed (Hennadii Stepanov)

Pull request description:

  This PR is a follow-up to #34256. It extends functional test support to illumos-based OSes and fixes several related issues on the *BSDs.

  Changes:
  - Make `lsof` an optional functional test dependency via a new `skip_if_no_lsof` helper, consistent with other optional test deps.
  - Strip the CIDR prefix length from NetBSD `ifconfig` output (no-op on other platforms).
  - Suppress spurious `lsof` warnings on NetBSD.
  - Drop OpenBSD from the platforms supported by `get_bind_addrs`.
  - Document the `lsof` Test Suite Dependency for FreeBSD and NetBSD.
  - Add support for `get_bind_addrs` and `feature_bind_extra` on illumos.

  CI runs: https://github.com/hebasto/bitcoin-core-nightly/pull/280.

  Addresses https://github.com/bitcoin/bitcoin/pull/34256#issuecomment-4361855749.

ACKs for top commit:
  l0rinc:
    Lightly tested code review ACK f4a6d079c4
  sedited:
    utACK f4a6d079c4

Tree-SHA512: 24d943d059f5fa3f5626017eff744836177a41724544355f34b3a31fdf287bd1916bc6e903b598c1c55b61da2ff0f931b4455542d9cff6cf399ef7963096dff4

2026-08-04 17:23:26 +02:00

3.3 KiB

Raw Blame History

NetBSD Build Guide

Bitcoin Core is supported on all supported NetBSD releases.

This guide describes how to build bitcoind, command-line utilities, and GUI on the latest release.

Preparation

1. Install Required Dependencies

Install the required dependencies the usual way you install software on NetBSD. The example commands below use pkgin.

pkgin install git cmake boost

NetBSD currently ships with an older version of gcc than is needed to build. You should upgrade your gcc and then pass this new version to the CMake configuration.

For example, grab gcc12:

pkgin install gcc12

Then, when configuring, pass the following:

cmake -B build
    ...
    -DCMAKE_C_COMPILER="/usr/pkg/gcc12/bin/gcc" \
    -DCMAKE_CXX_COMPILER="/usr/pkg/gcc12/bin/g++" \
    ...

SQLite is required for the wallet:

pkgin install sqlite3

To build Bitcoin Core without the wallet, use -DENABLE_WALLET=OFF.

Cap'n Proto is needed for IPC functionality (see multiprocess.md):

pkgin install capnproto

Compile with -DENABLE_IPC=OFF if you do not need IPC functionality.

See dependencies.md for a complete overview.

2. Clone Bitcoin Repo

Clone the Bitcoin Core repository to a directory. All build scripts and commands will run from this directory.

git clone https://github.com/bitcoin/bitcoin.git

3. Install Optional Dependencies

GUI Dependencies

Qt6

Bitcoin Core includes a GUI built with the cross-platform Qt Framework. To compile the GUI, we need to install the necessary parts of Qt, the libqrencode and pass -DBUILD_GUI=ON. Skip if you don't intend to use the GUI.

pkgin install qt6-qtbase qt6-qttools

libqrencode

The GUI will be able to encode addresses in QR codes unless this feature is explicitly disabled. To install libqrencode, run:

pkgin install qrencode

Otherwise, if you don't need QR encoding support, use the -DWITH_QRENCODE=OFF option to disable this feature in order to compile the GUI.

Notifications

ZeroMQ

Bitcoin Core can provide notifications via ZeroMQ. To compile ZMQ support, install the following dependency and pass -DWITH_ZMQ=ON when configuring.

pkgin install zeromq pkg-config

Test Suite Dependencies

There is an included test suite that is useful for testing code changes when developing. To run the test suite (recommended), you will need to have Python 3 installed:

pkgin install python313 py313-zmq lsof

When the lsof binary package was built for a different point release, it might be necessary to force its installation as follows:

echo "CHECK_OSABI=no" >> /etc/pkg_install.conf
pkgin install lsof

Building Bitcoin Core

1. Configuration

There are many ways to configure Bitcoin Core. Here is an example that explicitly disables the wallet and GUI:

cmake -B build -DENABLE_WALLET=OFF -DBUILD_GUI=OFF

Run cmake -B build -LH to see the full list of available options.

2. Compile

Build and run the tests:

cmake --build build     # Append "-j N" for N parallel jobs.
ctest --test-dir build  # Append "-j N" for N parallel tests.

3.3 KiB Raw Blame History