215 lines
11 KiB
Plaintext
215 lines
11 KiB
Plaintext
`configure' configures tor 0.4.8.0-alpha-dev 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/tor]
|
|
--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")
|
|
--enable-dependency-tracking
|
|
do not reject slow dependency extractors
|
|
--disable-dependency-tracking
|
|
speeds up one-time build
|
|
--enable-openbsd-malloc use malloc code from OpenBSD. Linux only.
|
|
Deprecated: see --with-malloc
|
|
--enable-static-openssl link against a static openssl library. Requires
|
|
--with-openssl-dir
|
|
--enable-static-libevent
|
|
link against a static libevent library. Requires
|
|
--with-libevent-dir
|
|
--enable-static-zlib link against a static zlib library. Requires
|
|
--with-zlib-dir
|
|
--enable-static-tor create an entirely static Tor binary. Requires
|
|
--with-openssl-dir and --with-libevent-dir and
|
|
--with-zlib-dir
|
|
--disable-unittests don't build unit tests for Tor. Risky!
|
|
--enable-coverage enable coverage support in the unit-test build
|
|
--disable-asserts-in-tests
|
|
disable tor_assert() calls in the unit tests, for
|
|
branch coverage
|
|
--disable-system-torrc don't look for a system-wide torrc file
|
|
--enable-libfuzzer build extra fuzzers based on 'libfuzzer'
|
|
--enable-oss-fuzz build extra fuzzers based on 'oss-fuzz' environment
|
|
--disable-memory-sentinels
|
|
disable code that tries to prevent some kinds of
|
|
memory access bugs. For fuzzing only.
|
|
--enable-restart-debugging
|
|
Build Tor with support for debugging in-process
|
|
restart. Developers only.
|
|
--disable-zstd-advanced-apis
|
|
Build without support for zstd's "static-only" APIs.
|
|
--enable-nss Use Mozilla's NSS TLS library. (EXPERIMENTAL)
|
|
--enable-pic Build Tor's binaries as position-independent code,
|
|
suitable to link as a library.
|
|
--enable-missing-doc-warnings
|
|
Tell doxygen to warn about missing documentation.
|
|
Makes doxygen warnings nonfatal.
|
|
--disable-manpage Disable manpage generation.
|
|
--disable-html-manual Disable HTML documentation.
|
|
--disable-asciidoc don't use asciidoc (disables building of manpages)
|
|
--enable-systemd enable systemd notification support
|
|
--enable-gcc-warnings deprecated alias for enable-fatal-warnings
|
|
--enable-fatal-warnings tell the compiler to treat all warnings as errors.
|
|
--disable-gcc-warnings-advisory
|
|
disable the regular verbose warnings
|
|
--disable-gcc-hardening disable compiler security checks
|
|
--enable-expensive-hardening
|
|
enable more fragile and expensive compiler
|
|
hardening; makes Tor slower
|
|
--enable-fragile-hardening
|
|
enable more fragile and expensive compiler
|
|
hardening; makes Tor slower
|
|
--enable-all-bugs-are-fatal
|
|
force all soft asserts in Tor codebase
|
|
(tor_assert_nonfatal(), BUG(), etc.) to act as hard
|
|
asserts (tor_assert() and equivalents); makes Tor
|
|
fragile; only recommended for dev builds
|
|
--disable-linker-hardening
|
|
disable linker security fixups
|
|
--enable-local-appdata default to host local application data paths on
|
|
Windows
|
|
--disable-tool-name-check
|
|
check for sanely named toolchain when
|
|
cross-compiling
|
|
--disable-seccomp do not attempt to use libseccomp
|
|
--disable-libscrypt do not attempt to use libscrypt
|
|
--enable-tracing-instrumentation-lttng
|
|
build with LTTng-UST instrumentation
|
|
--enable-tracing-instrumentation-usdt
|
|
build with tracing USDT instrumentation
|
|
--enable-tracing-instrumentation-log-debug
|
|
build with tracing event to debug log
|
|
--enable-android build with Android features enabled
|
|
--disable-module-relay Build tor without the Relay modules: tor can not run
|
|
as a relay, bridge, or authority. Implies
|
|
--disable-module-dirauth
|
|
--disable-module-dirauth
|
|
Build tor without the Directory Authority module:
|
|
tor can not run as a directory authority or bridge
|
|
authority
|
|
--enable-lzma enable support for the LZMA compression scheme.
|
|
--enable-zstd enable support for the Zstandard compression scheme.
|
|
--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-tor-user=NAME specify username for tor daemon
|
|
--with-tor-group=NAME specify group name for tor daemon
|
|
--with-libevent-dir=PATH
|
|
specify path to libevent installation
|
|
--with-ssl-dir=PATH obsolete alias for --with-openssl-dir
|
|
--with-openssl-dir=PATH specify path to openssl installation
|
|
--with-zlib-dir=PATH specify path to zlib installation
|
|
--with-tcmalloc use tcmalloc memory allocation library. Deprecated;
|
|
see --with-malloc
|
|
--with-malloc=system,jemalloc,tcmalloc,openbsd
|
|
select special malloc implementation [system]
|
|
--with-syslog-facility=LOG
|
|
syslog facility to use (default=LOG_DAEMON)
|
|
|
|
Some influential environment variables:
|
|
CC C compiler command
|
|
CFLAGS 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>
|
|
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
|
|
SYSTEMD_CFLAGS
|
|
C compiler flags for SYSTEMD, overriding pkg-config
|
|
SYSTEMD_LIBS
|
|
linker flags for SYSTEMD, overriding pkg-config
|
|
LIBSYSTEMD209_CFLAGS
|
|
C compiler flags for LIBSYSTEMD209, overriding pkg-config
|
|
LIBSYSTEMD209_LIBS
|
|
linker flags for LIBSYSTEMD209, overriding pkg-config
|
|
CPP C preprocessor
|
|
PERL path to Perl binary
|
|
NSS_CFLAGS C compiler flags for NSS, overriding pkg-config
|
|
NSS_LIBS linker flags for NSS, overriding pkg-config
|
|
LZMA_CFLAGS C compiler flags for LZMA, overriding pkg-config
|
|
LZMA_LIBS linker flags for LZMA, overriding pkg-config
|
|
ZSTD_CFLAGS C compiler flags for ZSTD, overriding pkg-config
|
|
ZSTD_LIBS linker flags for ZSTD, overriding pkg-config
|
|
TCMALLOC_CFLAGS
|
|
C compiler flags for TCMALLOC, overriding pkg-config
|
|
TCMALLOC_LIBS
|
|
linker flags for TCMALLOC, overriding pkg-config
|
|
JEMALLOC_CFLAGS
|
|
C compiler flags for JEMALLOC, overriding pkg-config
|
|
JEMALLOC_LIBS
|
|
linker flags for JEMALLOC, 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 the package provider.
|