-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathmake-configure.help
More file actions
329 lines (314 loc) · 17 KB
/
make-configure.help
File metadata and controls
329 lines (314 loc) · 17 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
root@f013677e4674:/bitcoin-0.21.1# ./configure --help
`configure' configures Bitcoin Core 0.21.1 to adapt to many kinds of systems.
Usage: ./configure [OPTION]... [VAR=VALUE]...
To assign environment variables (e.g., CC, CFLAGS...), specify them as
VAR=VALUE. See below for descriptions of some of the useful variables.
Defaults for the options are specified in brackets.
Configuration:
-h, --help display this help and exit
--help=short display options specific to this package
--help=recursive display the short help of all the included packages
-V, --version display version information and exit
-q, --quiet, --silent do not print `checking ...' messages
--cache-file=FILE cache test results in FILE [disabled]
-C, --config-cache alias for `--cache-file=config.cache'
-n, --no-create do not create output files
--srcdir=DIR find the sources in DIR [configure dir or `..']
Installation directories:
--prefix=PREFIX install architecture-independent files in PREFIX
[/usr/local]
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
[PREFIX]
By default, `make install' will install all the files in
`/usr/local/bin', `/usr/local/lib' etc. You can specify
an installation prefix other than `/usr/local' using `--prefix',
for instance `--prefix=$HOME'.
For better control, use the options below.
Fine tuning of the installation directories:
--bindir=DIR user executables [EPREFIX/bin]
--sbindir=DIR system admin executables [EPREFIX/sbin]
--libexecdir=DIR program executables [EPREFIX/libexec]
--sysconfdir=DIR read-only single-machine data [PREFIX/etc]
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
--localstatedir=DIR modifiable single-machine data [PREFIX/var]
--runstatedir=DIR modifiable per-process data [LOCALSTATEDIR/run]
--libdir=DIR object code libraries [EPREFIX/lib]
--includedir=DIR C header files [PREFIX/include]
--oldincludedir=DIR C header files for non-gcc [/usr/include]
--datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
--datadir=DIR read-only architecture-independent data [DATAROOTDIR]
--infodir=DIR info documentation [DATAROOTDIR/info]
--localedir=DIR locale-dependent data [DATAROOTDIR/locale]
--mandir=DIR man documentation [DATAROOTDIR/man]
--docdir=DIR documentation root [DATAROOTDIR/doc/bitcoin]
--htmldir=DIR html documentation [DOCDIR]
--dvidir=DIR dvi documentation [DOCDIR]
--pdfdir=DIR pdf documentation [DOCDIR]
--psdir=DIR ps documentation [DOCDIR]
Program names:
--program-prefix=PREFIX prepend PREFIX to installed program names
--program-suffix=SUFFIX append SUFFIX to installed program names
--program-transform-name=PROGRAM run sed PROGRAM on installed program names
System types:
--build=BUILD configure for building on BUILD [guessed]
--host=HOST cross-compile to build programs to run on HOST [BUILD]
Optional Features:
--disable-option-checking ignore unrecognized --enable/--with options
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
--enable-silent-rules less verbose build output (undo: "make V=1")
--disable-silent-rules verbose build output (undo: "make V=0")
--disable-maintainer-mode
disable make rules and dependencies not useful (and
sometimes confusing) to the casual installer
--enable-dependency-tracking
do not reject slow dependency extractors
--disable-dependency-tracking
speeds up one-time build
--enable-c++17 enable compilation in c++17 mode (disabled by
default)
--enable-shared[=PKGS] build shared libraries [default=yes]
--enable-static[=PKGS] build static libraries [default=yes]
--enable-fast-install[=PKGS]
optimize for fast installation [default=yes]
--disable-libtool-lock avoid locking (might break parallel builds)
--disable-wallet disable wallet (enabled by default)
--enable-upnp-default if UPNP is enabled, turn it on at startup (default
is no)
--disable-tests do not compile tests (default is to compile)
--disable-gui-tests do not compile GUI tests (default is to compile if
GUI and tests enabled)
--disable-bench do not compile benchmarks (default is to compile)
--enable-extended-functional-tests
enable expensive functional tests when using lcov
(default no)
--enable-fuzz enable building of fuzz targets (default no).
enabling this will disable all other targets
--disable-hardening do not attempt to harden the resulting executables
(default is to harden when possible)
--enable-reduce-exports attempt to reduce exported symbols in the resulting
executables (default is no)
--disable-ccache do not use ccache for building (default is to use if
found)
--enable-suppress-external-warnings
Suppress warnings from external headers (default is
no)
--enable-lcov enable lcov testing (default is no)
--enable-lcov-branch-coverage
enable lcov testing branch coverage (default is no)
--enable-glibc-back-compat
enable backwards compatibility with glibc
--enable-threadlocal enable features that depend on the c++ thread_local
keyword (currently just thread names in debug logs).
(default is to enabled if there is platform support
and glibc-back-compat is not enabled)
--disable-asm disable assembly routines (enabled by default)
--disable-zmq disable ZMQ notifications
--enable-multiprocess build multiprocess bitcoin-node, bitcoin-wallet, and
bitcoin-gui executables in addition to monolithic
bitcoind and bitcoin-qt executables. Requires
libmultiprocess library. Experimental (default is
no)
--disable-man do not install man pages (default is to install)
--enable-debug use compiler flags and macros suited for debugging
(default is no)
--enable-gprof use gprof profiling compiler flags (default is no)
--enable-determinism Enable compilation flags that make builds
deterministic (default is no)
--enable-werror Treat certain compiler warnings as errors (default
is no)
--enable-util-cli build bitcoin-cli
--enable-util-tx build bitcoin-tx
--enable-util-wallet build bitcoin-wallet
--disable-largefile omit support for large files
Optional Packages:
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
--with-pic[=PKGS] try to use only PIC/non-PIC objects [default=use
both]
--with-aix-soname=aix|svr4|both
shared library versioning (aka "SONAME") variant to
provide on AIX, [default=aix].
--with-gnu-ld assume the C compiler uses GNU ld [default=no]
--with-sysroot[=DIR] Search for dependent libraries within DIR (or the
compiler's sysroot if not specified).
--with-sqlite=yes|no|auto
enable sqlite wallet support (default: auto, i.e.,
enabled if wallet is enabled and sqlite is found)
--with-miniupnpc enable UPNP (default is yes if libminiupnpc is
found)
--with-qrencode enable QR code support (default is yes if qt is
enabled and libqrencode is found)
--with-system-univalue Build with system UniValue (default is no)
--with-libmultiprocess=yes|no|auto
Build with libmultiprocess library. (default: auto,
i.e. detect with pkg-config)
--with-mpgen=yes|no|auto|PREFIX
Build with libmultiprocess codegen tool. Useful to
specify different libmultiprocess host system
library and build system codegen tool prefixes when
cross-compiling (default is host system
libmultiprocess prefix)
--with-sanitizers comma separated list of extra sanitizers to build
with (default is none enabled)
--with-utils build bitcoin-cli bitcoin-tx bitcoin-wallet
(default=yes)
--with-libs build libraries (default=yes)
--with-daemon build bitcoind daemon (default=yes)
--with-gui[=no|qt5|auto]
build bitcoin-qt GUI (default=auto)
--with-qt-incdir=INC_DIR
specify qt include path (overridden by pkgconfig)
--with-qt-libdir=LIB_DIR
specify qt lib path (overridden by pkgconfig)
--with-qt-plugindir=PLUGIN_DIR
specify qt plugin path (overridden by pkgconfig)
--with-qt-translationdir=PLUGIN_DIR
specify qt translation path (overridden by
pkgconfig)
--with-qt-bindir=BIN_DIR
specify qt bin path
--with-qtdbus enable DBus support (default is yes if qt is enabled
and QtDBus is found, except on Android)
--with-incompatible-bdb allow using a bdb version other than 4.8
--with-boost[=ARG] use Boost library from a standard location
(ARG=yes), from the specified location (ARG=<path>),
or disable it (ARG=no) [ARG=yes]
--with-boost-libdir=LIB_DIR
Force given directory for boost libraries. Note that
this will override library path detection, so use
this parameter only if default library detection
fails and you know exactly where your boost
libraries are located.
--with-boost-system[=special-lib]
use the System library from boost - it is possible
to specify a certain library for the linker e.g.
--with-boost-system=boost_system-gcc-mt
--with-boost-filesystem[=special-lib]
use the Filesystem library from boost - it is
possible to specify a certain library for the linker
e.g. --with-boost-filesystem=boost_filesystem-gcc-mt
--with-boost-thread[=special-lib]
use the Thread library from boost - it is possible
to specify a certain library for the linker e.g.
--with-boost-thread=boost_thread-gcc-mt
--with-boost-process[=special-lib]
use the Process library from boost - it is possible
to specify a certain library for the linker e.g.
--with-boost-process=boost_process-gcc-mt
--with-boost-unit-test-framework[=special-lib]
use the Unit_Test_Framework library from boost - it
is possible to specify a certain library for the
linker e.g.
--with-boost-unit-test-framework=boost_unit_test_framework-gcc
Some influential environment variables:
PKG_CONFIG path to pkg-config utility
PKG_CONFIG_PATH
directories to add to pkg-config's search path
PKG_CONFIG_LIBDIR
path overriding pkg-config's built-in search path
ARFLAGS Flags for the archiver, defaults to <cr> if not set
CXX C++ compiler command
CXXFLAGS C++ compiler flags
LDFLAGS linker flags, e.g. -L<lib dir> if you have libraries in a
nonstandard directory <lib dir>
LIBS libraries to pass to the linker, e.g. -l<library>
CPPFLAGS (Objective) C/C++ preprocessor flags, e.g. -I<include dir> if
you have headers in a nonstandard directory <include dir>
OBJCXX Objective C++ compiler command
OBJCXXFLAGS Objective C++ compiler flags
CC C compiler command
CFLAGS C compiler flags
LT_SYS_LIBRARY_PATH
User-defined run-time library search path.
CPP C preprocessor
CXXCPP C++ preprocessor
PYTHONPATH Augments the default search path for python module files
QT_CORE_CFLAGS
C compiler flags for QT_CORE, overriding pkg-config
QT_CORE_LIBS
linker flags for QT_CORE, overriding pkg-config
QT_GUI_CFLAGS
C compiler flags for QT_GUI, overriding pkg-config
QT_GUI_LIBS linker flags for QT_GUI, overriding pkg-config
QT_WIDGETS_CFLAGS
C compiler flags for QT_WIDGETS, overriding pkg-config
QT_WIDGETS_LIBS
linker flags for QT_WIDGETS, overriding pkg-config
QT_NETWORK_CFLAGS
C compiler flags for QT_NETWORK, overriding pkg-config
QT_NETWORK_LIBS
linker flags for QT_NETWORK, overriding pkg-config
QT_TEST_CFLAGS
C compiler flags for QT_TEST, overriding pkg-config
QT_TEST_LIBS
linker flags for QT_TEST, overriding pkg-config
QT_DBUS_CFLAGS
C compiler flags for QT_DBUS, overriding pkg-config
QT_DBUS_LIBS
linker flags for QT_DBUS, overriding pkg-config
QTFONTDATABASE_CFLAGS
C compiler flags for QTFONTDATABASE, overriding pkg-config
QTFONTDATABASE_LIBS
linker flags for QTFONTDATABASE, overriding pkg-config
QTEVENTDISPATCHER_CFLAGS
C compiler flags for QTEVENTDISPATCHER, overriding pkg-config
QTEVENTDISPATCHER_LIBS
linker flags for QTEVENTDISPATCHER, overriding pkg-config
QTTHEME_CFLAGS
C compiler flags for QTTHEME, overriding pkg-config
QTTHEME_LIBS
linker flags for QTTHEME, overriding pkg-config
QTDEVICEDISCOVERY_CFLAGS
C compiler flags for QTDEVICEDISCOVERY, overriding pkg-config
QTDEVICEDISCOVERY_LIBS
linker flags for QTDEVICEDISCOVERY, overriding pkg-config
QTACCESSIBILITY_CFLAGS
C compiler flags for QTACCESSIBILITY, overriding pkg-config
QTACCESSIBILITY_LIBS
linker flags for QTACCESSIBILITY, overriding pkg-config
QTFB_CFLAGS C compiler flags for QTFB, overriding pkg-config
QTFB_LIBS linker flags for QTFB, overriding pkg-config
QTXCBQPA_CFLAGS
C compiler flags for QTXCBQPA, overriding pkg-config
QTXCBQPA_LIBS
linker flags for QTXCBQPA, overriding pkg-config
QTCLIPBOARD_CFLAGS
C compiler flags for QTCLIPBOARD, overriding pkg-config
QTCLIPBOARD_LIBS
linker flags for QTCLIPBOARD, overriding pkg-config
QTGRAPHICS_CFLAGS
C compiler flags for QTGRAPHICS, overriding pkg-config
QTGRAPHICS_LIBS
linker flags for QTGRAPHICS, overriding pkg-config
QTCGL_CFLAGS
C compiler flags for QTCGL, overriding pkg-config
QTCGL_LIBS linker flags for QTCGL, overriding pkg-config
BDB_CFLAGS C compiler flags for BerkeleyDB, bypasses autodetection
BDB_LIBS Linker flags for BerkeleyDB, bypasses autodetection
SQLITE_CFLAGS
C compiler flags for SQLITE, overriding pkg-config
SQLITE_LIBS linker flags for SQLITE, overriding pkg-config
EVENT_CFLAGS
C compiler flags for EVENT, overriding pkg-config
EVENT_LIBS linker flags for EVENT, overriding pkg-config
EVENT_PTHREADS_CFLAGS
C compiler flags for EVENT_PTHREADS, overriding pkg-config
EVENT_PTHREADS_LIBS
linker flags for EVENT_PTHREADS, overriding pkg-config
QR_CFLAGS C compiler flags for QR, overriding pkg-config
QR_LIBS linker flags for QR, overriding pkg-config
ZMQ_CFLAGS C compiler flags for ZMQ, overriding pkg-config
ZMQ_LIBS linker flags for ZMQ, overriding pkg-config
UNIVALUE_CFLAGS
C compiler flags for UNIVALUE, overriding pkg-config
UNIVALUE_LIBS
linker flags for UNIVALUE, overriding pkg-config
LIBMULTIPROCESS_CFLAGS
C compiler flags for LIBMULTIPROCESS, overriding pkg-config
LIBMULTIPROCESS_LIBS
linker flags for LIBMULTIPROCESS, overriding pkg-config
Use these variables to override the choices made by `configure' or to help
it to find libraries and programs with nonstandard names/locations.
Report bugs to <https://github.com/bitcoin/bitcoin/issues>.
Bitcoin Core home page: <https://bitcoincore.org/>.