blob: 23ceacef0067cbe35178b6916765265568fb7e72 [file] [log] [blame]
Willy Tarreau9f2b7302008-01-02 20:48:34 +01001# This GNU Makefile supports different OS and CPU combinations.
2#
willy tarreaueedaa9f2005-12-17 14:08:03 +01003# You should use it this way :
Willy Tarreau50b1aae2019-06-14 15:52:01 +02004# [g]make TARGET=os [ARCH=arch] [CPU=cpu] USE_xxx=1 ...
5#
6# When in doubt, invoke help, possibly with a known target :
7# [g]make help
Willy Tarreau61cf0dc2019-06-14 16:32:09 +02008# [g]make help TARGET=linux-glibc
Willy Tarreauf2ef8c52007-07-11 09:19:31 +02009#
Willy Tarreau16119652018-11-19 08:15:54 +010010# By default the detailed commands are hidden for a cleaner output, but you may
11# see them by appending "V=1" to the make command.
12#
Willy Tarreau05fd82d2019-03-27 10:57:49 +010013# Valid USE_* options are enumerated in the "use_opts" variable and are listed
14# below. Most of them are automatically set by the TARGET, others have to be
15# explicitly specified :
Willy Tarreau9f2b7302008-01-02 20:48:34 +010016# USE_EPOLL : enable epoll() on Linux 2.6. Automatic.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010017# USE_KQUEUE : enable kqueue() on BSD. Automatic.
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +000018# USE_EVPORTS : enable event ports on SunOS systems. Automatic.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010019# USE_NETFILTER : enable netfilter on Linux. Automatic.
20# USE_PCRE : enable use of libpcre for regex. Recommended.
Willy Tarreau91418062013-04-04 23:05:32 +020021# USE_PCRE_JIT : enable JIT for faster regex on libpcre >= 8.32
David Carlierf2592b22016-11-21 21:25:58 +000022# USE_PCRE2 : enable use of libpcre2 for regex.
23# USE_PCRE2_JIT : enable JIT for faster regex on libpcre2
Willy Tarreau9f2b7302008-01-02 20:48:34 +010024# USE_POLL : enable poll(). Automatic.
Emeric Brun9faf0712012-09-25 11:11:16 +020025# USE_PRIVATE_CACHE : disable shared memory cache of ssl sessions.
Christopher Fauleta1ae7e82017-10-25 17:55:27 +020026# USE_THREAD : enable threads support.
Emeric Bruncd1a5262014-05-07 23:11:42 +020027# USE_PTHREAD_PSHARED : enable pthread process shared mutex on sslcache.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010028# USE_STATIC_PCRE : enable static libpcre. Recommended.
David Carlierf2592b22016-11-21 21:25:58 +000029# USE_STATIC_PCRE2 : enable static libpcre2.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010030# USE_TPROXY : enable transparent proxy. Automatic.
Willy Tarreaue0c623d2012-06-04 00:42:09 +020031# USE_LINUX_TPROXY : enable full transparent proxy. Automatic.
32# USE_LINUX_SPLICE : enable kernel 2.6 splicing. Automatic.
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -070033# USE_LIBCRYPT : enable encrypted passwords using -lcrypt
Willy Tarreau890a33e2010-03-04 19:10:14 +010034# USE_CRYPT_H : set it if your system requires including crypt.h
Willy Tarreau64bc40b2011-03-23 20:00:53 +010035# USE_GETADDRINFO : use getaddrinfo() to resolve IPv6 host names.
Emeric Brun7444f012012-05-18 15:48:30 +020036# USE_OPENSSL : enable use of OpenSSL. Recommended, but see below.
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +010037# USE_LUA : enable Lua support.
Emeric Brun3e541d12012-09-03 11:14:36 +020038# USE_FUTEX : enable use of futex on kernel 2.6. Automatic.
Willy Tarreau1bc4aab2012-10-08 20:11:03 +020039# USE_ACCEPT4 : enable use of accept4() on linux. Automatic.
Brad Smith5018aac2020-09-30 01:04:48 -040040# USE_CLOSEFROM : enable use of closefrom() on *bsd, solaris. Automatic.
Willy Tarreau636848a2019-04-15 19:38:50 +020041# USE_PRCTL : enable use of prctl(). Automatic.
devnexen@gmail.com078062b2021-08-21 09:13:10 +010042# USE_PROCCTL : enable use of procctl(). Automatic.
Willy Tarreau12840be2021-04-22 14:14:22 +020043# USE_ZLIB : enable zlib library support and disable SLZ
44# USE_SLZ : enable slz library instead of zlib (default=enabled)
Willy Tarreaufc6c0322012-11-16 16:12:27 +010045# USE_CPU_AFFINITY : enable pinning processes to CPU on Linux. Automatic.
Lukas Tribus0999f762013-04-02 16:43:24 +020046# USE_TFO : enable TCP fast open. Supported on Linux >= 3.7.
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +010047# USE_NS : enable network namespace support. Supported on Linux >= 2.6.24.
Willy Tarreau71b99ef2015-03-17 14:33:22 +010048# USE_DL : enable it if your system requires -ldl. Automatic on Linux.
Willy Tarreau58e90cb2018-10-18 16:28:54 +020049# USE_RT : enable it if your system requires -lrt. Automatic on Linux.
Willy Tarreauf5b4e062020-03-03 15:40:23 +010050# USE_BACKTRACE : enable backtrace(). Automatic on Linux.
Willy Tarreau92dc7862021-04-02 15:31:10 +020051# USE_PROMEX : enable the Prometheus exporter
David Carliera03fb142015-06-01 14:00:07 +020052# USE_DEVICEATLAS : enable DeviceAtlas api.
Dragan Dosen93b38d92015-06-29 16:43:25 +020053# USE_51DEGREES : enable third party device detection library from 51Degrees
Willy Tarreaub3cc9f22019-04-19 16:03:32 +020054# USE_WURFL : enable WURFL detection library from Scientiamobile
Tim Duesterhusd6942c82017-11-20 15:58:35 +010055# USE_SYSTEMD : enable sd_notify() support.
Willy Tarreau7b5654f2019-03-29 21:30:17 +010056# USE_OBSOLETE_LINKER : use when the linker fails to emit __start_init/__stop_init
Willy Tarreauc7091d82019-05-17 10:08:49 +020057# USE_THREAD_DUMP : use the more advanced thread state dump system. Automatic.
Miroslav Zagorac70230c62020-12-09 16:54:31 +010058# USE_OT : enable the OpenTracing filter
Willy Tarreauf6818d62021-05-05 18:17:39 +020059# USE_MEMORY_PROFILING : enable the memory profiler. Linux-glibc only.
Willy Tarreaud5d6fdc2021-11-14 15:28:38 +010060# USE_LIBATOMIC : force to link with/without libatomic. Automatic.
Willy Tarreauf2ef8c52007-07-11 09:19:31 +020061#
Willy Tarreau9f2b7302008-01-02 20:48:34 +010062# Options can be forced by specifying "USE_xxx=1" or can be disabled by using
Willy Tarreau50b1aae2019-06-14 15:52:01 +020063# "USE_xxx=" (empty string). The list of enabled and disabled options for a
64# given TARGET is enumerated at the end of "make help".
Willy Tarreau9f2b7302008-01-02 20:48:34 +010065#
66# Variables useful for packagers :
Brad Smith94636432020-09-13 02:53:06 -040067# CC is set to "cc" by default and is used for compilation only.
68# LD is set to "cc" by default and is used for linking only.
Willy Tarreauef7341d2009-04-11 19:45:50 +020069# ARCH may be useful to force build of 32-bit binary on 64-bit systems
Willy Tarreau9f2b7302008-01-02 20:48:34 +010070# CFLAGS is automatically set for the specified CPU and may be overridden.
71# LDFLAGS is automatically set to -g and may be overridden.
Willy Tarreaub26835d2016-05-30 13:39:32 +020072# DEP may be cleared to ignore changes to include files during development
Willy Tarreau9f2b7302008-01-02 20:48:34 +010073# SMALL_OPTS may be used to specify some options to shrink memory usage.
74# DEBUG may be used to set some internal debugging options.
Willy Tarreau23cd43e2018-10-22 06:22:46 +020075# ERR may be set to non-empty to pass -Werror to the compiler
Willy Tarreau9f2b7302008-01-02 20:48:34 +010076# ADDINC may be used to complete the include path in the form -Ipath.
77# ADDLIB may be used to complete the library list in the form -Lpath -llib.
78# DEFINE may be used to specify any additional define, which will be reported
79# by "haproxy -vv" in CFLAGS.
80# SILENT_DEFINE may be used to specify other defines which will not be
81# reported by "haproxy -vv".
William Lallemanda6cfa902017-06-01 17:38:58 +020082# EXTRA is used to force building or not building some extra tools.
Christian Wiesea184aa22008-03-12 15:25:35 +020083# DESTDIR is not set by default and is used for installation only.
84# It might be useful to set DESTDIR if you want to install haproxy
85# in a sandbox.
86# PREFIX is set to "/usr/local" by default and is used for installation only.
87# SBINDIR is set to "$(PREFIX)/sbin" by default and is used for installation
88# only.
Christian Wiese19b50292008-03-12 15:57:54 +020089# MANDIR is set to "$(PREFIX)/share/man" by default and is used for
90# installation only.
Christian Wiesebf34eb42008-03-12 17:24:49 +020091# DOCDIR is set to "$(PREFIX)/doc/haproxy" by default and is used for
92# installation only.
Tim Duesterhus541fe1e2020-01-12 13:55:41 +010093# HLUA_PREPEND_PATH may be used to prepend a folder to Lua's default package.path.
94# HLUA_PREPEND_CPATH may be used to prepend a folder to Lua's default package.cpath.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010095#
96# Other variables :
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +020097# PCRE_CONFIG : force the binary path to get pcre config (by default
98# pcre-config)
Willy Tarreau9f2b7302008-01-02 20:48:34 +010099# PCREDIR : force the path to libpcre.
Willy Tarreau39793092013-02-13 12:39:06 +0100100# PCRE_LIB : force the lib path to libpcre (defaults to $PCREDIR/lib).
101# PCRE_INC : force the include path to libpcre ($PCREDIR/inc)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200102# PCRE2_CONFIG : force the binary path to get pcre2 config (by default
103# pcre2-config)
Willy Tarreau9a059452013-09-17 15:26:39 +0200104# SSL_LIB : force the lib path to libssl/libcrypto
105# SSL_INC : force the include path to libssl/libcrypto
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100106# LUA_LIB : force the lib path to lua
107# LUA_INC : force the include path to lua
Cyril Bontéc21adb52015-03-03 23:13:03 +0100108# LUA_LIB_NAME : force the lib name (or automatically evaluated, by order of
Thierry FOURNIERf90838b2015-03-06 13:48:32 +0100109# priority : lua5.3, lua53, lua).
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100110# OT_DEBUG : compile the OpenTracing filter in debug mode
111# OT_INC : force the include path to libopentracing-c-wrapper
112# OT_LIB : force the lib path to libopentracing-c-wrapper
113# OT_RUNPATH : add RUNPATH for libopentracing-c-wrapper to haproxy executable
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100114# IGNOREGIT : ignore GIT commit versions if set.
115# VERSION : force haproxy version reporting.
116# SUBVERS : add a sub-version (eg: platform, model, ...).
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200117# EXTRAVERSION : local version string to append (e.g. build number etc)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100118# VERDATE : force haproxy's release date.
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200119# VTEST_PROGRAM : location of the vtest program to run reg-tests.
Ilya Shipitsin4a034f22020-09-12 11:24:48 +0500120# DEBUG_USE_ABORT: use abort() for program termination, see include/haproxy/bug.h for details
Willy Tarreau4f60f162007-04-08 16:39:58 +0200121
Willy Tarreaub42233a2018-11-19 07:44:42 +0100122# verbosity: pass V=1 for verbose shell invocation
123V = 0
124Q = @
125ifeq ($V,1)
126Q=
127endif
128
Christopher Faulet16150642021-04-14 14:02:56 +0200129# WARNING: Do not change cc-opt, cc-opt-alt or cc-warning without checking if
130# clang bug #49364 is fixed. stderr is redirected to /dev/null on
131# purpose, to work around a clang 11 bug that crashes if stderr is
132# redirected to stdin.
133#
Willy Tarreaud3a7f402017-09-13 16:54:28 +0200134# Function used to detect support of a given option by the compiler.
135# Usage: CFLAGS += $(call cc-opt,option). Eg: $(call cc-opt,-fwrapv)
136# Note: ensure the referencing variable is assigned using ":=" and not "=" to
137# call it only once.
Christopher Faulet16150642021-04-14 14:02:56 +0200138cc-opt = $(shell set -e; if $(CC) -Werror $(1) -E -xc - -o /dev/null </dev/null >&0 2>/dev/null; then echo "$(1)"; fi;)
Willy Tarreaud3a7f402017-09-13 16:54:28 +0200139
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200140# same but emits $2 if $1 is not supported
Christopher Faulet16150642021-04-14 14:02:56 +0200141cc-opt-alt = $(shell set -e; if $(CC) -Werror $(1) -E -xc - -o /dev/null </dev/null >&0 2>/dev/null; then echo "$(1)"; else echo "$(2)"; fi;)
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200142
Willy Tarreaub7801662017-09-14 19:05:45 +0200143# Disable a warning when supported by the compiler. Don't put spaces around the
144# warning! And don't use cc-opt which doesn't always report an error until
145# another one is also returned.
146# Usage: CFLAGS += $(call cc-nowarn,warning). Eg: $(call cc-opt,format-truncation)
Christopher Faulet16150642021-04-14 14:02:56 +0200147cc-nowarn = $(shell set -e; if $(CC) -Werror -W$(1) -E -xc - -o /dev/null </dev/null >&0 2>/dev/null; then echo "-Wno-$(1)"; fi;)
Willy Tarreaub7801662017-09-14 19:05:45 +0200148
Christian Wiesea184aa22008-03-12 15:25:35 +0200149#### Installation options.
150DESTDIR =
151PREFIX = /usr/local
152SBINDIR = $(PREFIX)/sbin
Jeremy Hinegardneref3b4032008-11-15 17:29:03 -0700153MANDIR = $(PREFIX)/share/man
Christian Wiesebf34eb42008-03-12 17:24:49 +0200154DOCDIR = $(PREFIX)/doc/haproxy
Willy Tarreau4f60f162007-04-08 16:39:58 +0200155
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100156#### TARGET system
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500157# Use TARGET=<target_name> to optimize for a specific target OS among the
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100158# following list (use the default "generic" if uncertain) :
Brad Smith382001b2020-10-08 01:15:06 -0400159# linux-glibc, linux-glibc-legacy, linux-musl, solaris, freebsd, dragonfly,
160# openbsd, netbsd, cygwin, haiku, aix51, aix52, aix72-gcc, osx, generic,
161# custom
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100162TARGET =
Willy Tarreau4f60f162007-04-08 16:39:58 +0200163
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100164#### TARGET CPU
165# Use CPU=<cpu_name> to optimize for a particular CPU, among the following
166# list :
Willy Tarreau40a871f2021-05-12 09:47:30 +0200167# generic, native, i586, i686, ultrasparc, power8, power9, custom,
168# a53, a72, armv81, armv8-auto
willy tarreaueedaa9f2005-12-17 14:08:03 +0100169CPU = generic
willy tarreau036e1ce2005-12-17 13:46:33 +0100170
Willy Tarreauef7341d2009-04-11 19:45:50 +0200171#### Architecture, used when not building for native architecture
172# Use ARCH=<arch_name> to force build for a specific architecture. Known
173# architectures will lead to "-m32" or "-m64" being added to CFLAGS and
174# LDFLAGS. This can be required to build 32-bit binaries on 64-bit targets.
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100175# Currently, only 32, 64, x86_64, i386, i486, i586 and i686 are understood.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200176ARCH =
177
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100178#### Toolchain options.
Brad Smith94636432020-09-13 02:53:06 -0400179CC = cc
Christian Wiesef6308302008-03-17 18:23:12 +0100180LD = $(CC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100181
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100182#### Debug flags (typically "-g").
183# Those flags only feed CFLAGS so it is not mandatory to use this form.
184DEBUG_CFLAGS = -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100185
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200186#### Add -Werror when set to non-empty
187ERR =
188
Willy Tarreaudb863332018-11-23 08:29:15 +0100189#### May be used to force running a specific set of reg-tests
190REG_TEST_FILES =
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +0100191REG_TEST_SCRIPT=./scripts/run-regtests.sh
Willy Tarreaudb863332018-11-23 08:29:15 +0100192
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100193#### Compiler-specific flags that may be used to disable some negative over-
Willy Tarreaud1c847a2020-02-25 10:10:47 +0100194# optimization or to silence some warnings.
Olivier Houchard73bdb322017-04-19 11:34:10 +0200195# We rely on signed integer wraparound on overflow, however clang think it
196# can do whatever it wants since it's an undefined behavior, so use -fwrapv
197# to be sure we get the intended behavior.
Willy Tarreau4b61e692020-03-10 09:37:08 +0100198SPEC_CFLAGS := -Wall -Wextra -Wdeclaration-after-statement
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200199SPEC_CFLAGS += $(call cc-opt-alt,-fwrapv,$(call cc-opt,-fno-strict-overflow))
Willy Tarreaub7801662017-09-14 19:05:45 +0200200SPEC_CFLAGS += $(call cc-nowarn,address-of-packed-member)
Willy Tarreaueff9a9e2017-10-27 11:06:11 +0200201SPEC_CFLAGS += $(call cc-nowarn,unused-label)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200202SPEC_CFLAGS += $(call cc-nowarn,sign-compare)
203SPEC_CFLAGS += $(call cc-nowarn,unused-parameter)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200204SPEC_CFLAGS += $(call cc-nowarn,clobbered)
205SPEC_CFLAGS += $(call cc-nowarn,missing-field-initializers)
Olivier Houchard73bce432018-11-27 14:47:58 +0100206SPEC_CFLAGS += $(call cc-nowarn,cast-function-type)
Willy Tarreauc77c2d42019-09-24 09:43:34 +0200207SPEC_CFLAGS += $(call cc-nowarn,string-plus-int)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200208SPEC_CFLAGS += $(call cc-opt,-Wtype-limits)
209SPEC_CFLAGS += $(call cc-opt,-Wshift-negative-value)
210SPEC_CFLAGS += $(call cc-opt,-Wshift-overflow=2)
211SPEC_CFLAGS += $(call cc-opt,-Wduplicated-cond)
212SPEC_CFLAGS += $(call cc-opt,-Wnull-dereference)
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100213
Willy Tarreau4b61e692020-03-10 09:37:08 +0100214ifneq ($(ERR),)
215SPEC_CFLAGS += -Werror
216endif
217
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100218#### Memory usage tuning
219# If small memory footprint is required, you can reduce the buffer size. There
220# are 2 buffers per concurrent session, so 16 kB buffers will eat 32 MB memory
221# with 1000 concurrent sessions. Putting it slightly lower than a page size
222# will prevent the additional parameters to go beyond a page. 8030 bytes is
223# exactly 5.5 TCP segments of 1460 bytes and is generally good. Useful tuning
224# macros include :
225# SYSTEM_MAXCONN, BUFSIZE, MAXREWRITE, REQURI_LEN, CAPTURE_LEN.
226# Example: SMALL_OPTS = -DBUFSIZE=8030 -DMAXREWRITE=1030 -DSYSTEM_MAXCONN=1024
227SMALL_OPTS =
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100228
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100229#### Debug settings
230# You can enable debugging on specific code parts by setting DEBUG=-DDEBUG_xxx.
Willy Tarreau4c442b02020-07-04 12:43:46 +0200231# Use quotes and spaces if multiple options are needed (the DEBUG variables is
232# passed as-is to CFLAGS). Please check sources for their exact meaning or do
233# not use them at all. Some even more obscure ones might also be available
234# without appearing here. Currently defined DEBUG macros include DEBUG_FULL,
235# DEBUG_MEM_STATS, DEBUG_DONT_SHARE_POOLS, DEBUG_NO_LOCKLESS_POOLS, DEBUG_FD,
Willy Tarreau2d6f6282021-04-15 16:24:00 +0200236# DEBUG_NO_POOLS, DEBUG_FAIL_ALLOC, DEBUG_STRICT_NOCRASH, DEBUG_HPACK,
Willy Tarreaub23f0422021-02-16 18:44:00 +0100237# DEBUG_AUTH, DEBUG_SPOE, DEBUG_UAF, DEBUG_THREAD, DEBUG_STRICT, DEBUG_DEV,
William Lallemand60c3b8e2021-09-29 16:03:35 +0200238# DEBUG_TASK, DEBUG_MEMORY_POOLS.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100239DEBUG =
willy tarreau1c2ad212005-12-18 01:11:29 +0100240
Willy Tarreau7de211c2012-05-25 23:53:16 +0200241#### Trace options
242# Use TRACE=1 to trace function calls to file "trace.out" or to stderr if not
243# possible.
244TRACE =
245
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100246#### Additional include and library dirs
247# Redefine this if you want to add some special PATH to include/libs
248ADDINC =
249ADDLIB =
willy tarreau64a3cc32005-12-18 01:13:11 +0100250
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100251#### Specific macro definitions
252# Use DEFINE=-Dxxx to set any tunable macro. Anything declared here will appear
253# in the build options reported by "haproxy -vv". Use SILENT_DEFINE if you do
254# not want to pollute the report with complex defines.
Emeric Brun76d88952012-10-05 15:47:31 +0200255# The following settings might be of interest when SSL is enabled :
256# LISTEN_DEFAULT_CIPHERS is a cipher suite string used to set the default SSL
257# ciphers on "bind" lines instead of using OpenSSL's defaults.
258# CONNECT_DEFAULT_CIPHERS is a cipher suite string used to set the default
259# SSL ciphers on "server" lines instead of using OpenSSL's defaults.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100260DEFINE =
261SILENT_DEFINE =
willy tarreau0f7af912005-12-17 12:21:26 +0100262
William Lallemanda6cfa902017-06-01 17:38:58 +0200263#### extra programs to build
Willy Tarreaubc289da2014-05-10 12:16:21 +0200264# Force this to enable building extra programs or to disable them.
265# It's automatically appended depending on the targets.
266EXTRA =
willy tarreau5cbea6f2005-12-17 12:48:26 +0100267
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500268#### CPU dependent optimizations
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100269# Some CFLAGS are set by default depending on the target CPU. Those flags only
270# feed CPU_CFLAGS, which in turn feed CFLAGS, so it is not mandatory to use
271# them. You should not have to change these options. Better use CPU_CFLAGS or
272# even CFLAGS instead.
273CPU_CFLAGS.generic = -O2
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100274CPU_CFLAGS.native = -O2 -march=native
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100275CPU_CFLAGS.i586 = -O2 -march=i586
276CPU_CFLAGS.i686 = -O2 -march=i686
277CPU_CFLAGS.ultrasparc = -O6 -mcpu=v9 -mtune=ultrasparc
Christian Lachnerc1322302020-02-10 10:29:13 +0100278CPU_CFLAGS.power8 = -O2 -mcpu=power8 -mtune=power8
279CPU_CFLAGS.power9 = -O2 -mcpu=power9 -mtune=power9
Willy Tarreau40a871f2021-05-12 09:47:30 +0200280CPU_CFLAGS.a53 = -O2 -mcpu=cortex-a53
281CPU_CFLAGS.a72 = -O2 -mcpu=cortex-a72
282CPU_CFLAGS.armv81 = -O2 -march=armv8.1-a
283CPU_CFLAGS.armv8-auto = -O2 -march=armv8-a+crc -moutline-atomics
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100284CPU_CFLAGS = $(CPU_CFLAGS.$(CPU))
willy tarreau9da061b2005-12-17 12:29:56 +0100285
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500286#### ARCH dependent flags, may be overridden by CPU flags
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100287ARCH_FLAGS.32 = -m32
288ARCH_FLAGS.64 = -m64
Willy Tarreauef7341d2009-04-11 19:45:50 +0200289ARCH_FLAGS.i386 = -m32 -march=i386
290ARCH_FLAGS.i486 = -m32 -march=i486
291ARCH_FLAGS.i586 = -m32 -march=i586
292ARCH_FLAGS.i686 = -m32 -march=i686
293ARCH_FLAGS.x86_64 = -m64 -march=x86-64
294ARCH_FLAGS = $(ARCH_FLAGS.$(ARCH))
295
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100296#### Common CFLAGS
297# These CFLAGS contain general optimization options, CPU-specific optimizations
298# and debug flags. They may be overridden by some distributions which prefer to
299# set all of them at once instead of playing with the CPU and DEBUG variables.
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100300CFLAGS = $(ARCH_FLAGS) $(CPU_CFLAGS) $(DEBUG_CFLAGS) $(SPEC_CFLAGS)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100301
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100302#### Common LDFLAGS
303# These LDFLAGS are used as the first "ld" options, regardless of any library
304# path or any other option. They may be changed to add any linker-specific
305# option at the beginning of the ld command line.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200306LDFLAGS = $(ARCH_FLAGS) -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100307
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100308#### list of all "USE_*" options. These ones must be updated if new options are
309# added, so that the relevant options are properly added to the CFLAGS and to
310# the reported build options.
Willy Tarreau06c63ae2020-03-10 07:20:10 +0100311use_opts = USE_EPOLL USE_KQUEUE USE_NETFILTER \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100312 USE_PCRE USE_PCRE_JIT USE_PCRE2 USE_PCRE2_JIT USE_POLL \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100313 USE_PRIVATE_CACHE USE_THREAD USE_PTHREAD_PSHARED USE_BACKTRACE \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100314 USE_STATIC_PCRE USE_STATIC_PCRE2 USE_TPROXY USE_LINUX_TPROXY \
Willy Tarreauc3e926b2020-03-10 06:48:17 +0100315 USE_LINUX_SPLICE USE_LIBCRYPT USE_CRYPT_H \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100316 USE_GETADDRINFO USE_OPENSSL USE_LUA USE_FUTEX USE_ACCEPT4 \
Brad Smith5018aac2020-09-30 01:04:48 -0400317 USE_CLOSEFROM USE_ZLIB USE_SLZ USE_CPU_AFFINITY USE_TFO USE_NS \
Willy Tarreau14261982019-04-23 10:57:09 +0200318 USE_DL USE_RT USE_DEVICEATLAS USE_51DEGREES USE_WURFL USE_SYSTEMD \
devnexen@gmail.com078062b2021-08-21 09:13:10 +0100319 USE_OBSOLETE_LINKER USE_PRCTL USE_PROCCTL USE_THREAD_DUMP \
320 USE_EVPORTS USE_OT USE_QUIC USE_PROMEX USE_MEMORY_PROFILING
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100321
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100322#### Target system options
323# Depending on the target platform, some options are set, as well as some
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100324# CFLAGS and LDFLAGS. All variables pre-set here will not appear in the build
325# options string. They may be set to any value, but are historically set to
326# "implicit" which eases debugging. You should not have to change anything
327# there unless you're adding support for a new platform.
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100328default_opts = $(foreach name,$(1),$(eval $(name)=implicit))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100329
330# poll() is always supported, unless explicitly disabled by passing USE_POLL=""
331# on the make command line.
Willy Tarreau32e65ef2013-04-02 08:14:29 +0200332USE_POLL = default
333
Willy Tarreau12840be2021-04-22 14:14:22 +0200334# SLZ is always supported unless explicitly disabled by passing USE_SLZ=""
335# or disabled by enabling ZLIB using USE_ZLIB=1
336ifeq ($(USE_ZLIB),)
337USE_SLZ = default
338endif
339
Willy Tarreau39f19922019-03-27 11:44:19 +0100340# generic system target has nothing specific
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100341ifeq ($(TARGET),generic)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100342 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY)
Willy Tarreau39f19922019-03-27 11:44:19 +0100343endif
344
345# Haiku
Jerome Duval38932c32015-10-19 23:01:16 +0000346ifeq ($(TARGET),haiku)
Jerome Duval38932c32015-10-19 23:01:16 +0000347 TARGET_LDFLAGS = -lnetwork
David Carlierb2f06cc2021-06-19 14:42:43 +0000348 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Willy Tarreau39f19922019-03-27 11:44:19 +0100349endif
350
Willy Tarreau61cf0dc2019-06-14 16:32:09 +0200351# For linux >= 2.6.28 and glibc
352ifeq ($(TARGET),linux-glibc)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100353 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100354 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
355 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
Willy Tarreau364d6f52019-06-14 18:33:56 +0200356 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100357 USE_GETADDRINFO USE_BACKTRACE)
Willy Tarreau39f19922019-03-27 11:44:19 +0100358endif
359
Lukas Tribuscc1eb162019-09-01 16:48:36 +0200360# For linux >= 2.6.28, glibc without new features
361ifeq ($(TARGET),linux-glibc-legacy)
362 set_target_defaults = $(call default_opts, \
363 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
364 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
365 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_GETADDRINFO)
366endif
367
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200368# For linux >= 2.6.28 and musl
369ifeq ($(TARGET),linux-musl)
370 set_target_defaults = $(call default_opts, \
371 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
372 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
373 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
374 USE_GETADDRINFO)
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200375endif
376
Brad Smith7c503bb2020-09-30 15:46:16 -0400377# Solaris 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100378ifeq ($(TARGET),solaris)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100379 set_target_defaults = $(call default_opts, \
Emmanuel Hocdet7093c192019-05-21 09:12:03 +0000380 USE_POLL USE_TPROXY USE_LIBCRYPT USE_CRYPT_H USE_GETADDRINFO USE_THREAD \
Brad Smith7c503bb2020-09-30 15:46:16 -0400381 USE_RT USE_OBSOLETE_LINKER USE_EVPORTS USE_CLOSEFROM)
Emmanuel Hocdet3c0edfa2019-05-17 15:32:21 +0000382 TARGET_CFLAGS = -DFD_SETSIZE=65536 -D_REENTRANT -D_XOPEN_SOURCE=500 -D__EXTENSIONS__
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100383 TARGET_LDFLAGS = -lnsl -lsocket
Willy Tarreau39f19922019-03-27 11:44:19 +0100384endif
385
Brad Smith9d85eb02020-09-15 03:10:04 -0400386# FreeBSD 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100387ifeq ($(TARGET),freebsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100388 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100389 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
devnexen@gmail.com078062b2021-08-21 09:13:10 +0100390 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO USE_PROCCTL)
Willy Tarreau39f19922019-03-27 11:44:19 +0100391endif
392
Brad Smith382001b2020-10-08 01:15:06 -0400393# DragonFlyBSD 4.3 and above
394ifeq ($(TARGET),dragonfly)
395 set_target_defaults = $(call default_opts, \
396 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
397 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO)
398endif
399
Willy Tarreau39f19922019-03-27 11:44:19 +0100400# Mac OS/X
Willy Tarreau8624cab2013-04-02 08:17:43 +0200401ifeq ($(TARGET),osx)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100402 set_target_defaults = $(call default_opts, \
Brad Smithad5afba2020-10-09 19:26:23 -0400403 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
404 USE_GETADDRINFO)
Willy Tarreaub684e7a2018-03-05 15:37:04 +0100405 EXPORT_SYMBOL = -export_dynamic
Willy Tarreau39f19922019-03-27 11:44:19 +0100406endif
407
Brad Smith90c9d782020-09-26 23:05:25 -0400408# OpenBSD 6.3 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100409ifeq ($(TARGET),openbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100410 set_target_defaults = $(call default_opts, \
Matthieu Guegan496374e2020-11-20 10:50:39 +0100411 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_KQUEUE USE_ACCEPT4 \
412 USE_CLOSEFROM USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100413endif
414
Brad Smith0fdfe412020-10-08 16:24:52 -0400415# NetBSD 8 and above
David Carlierb5714da2015-07-02 06:58:22 +0000416ifeq ($(TARGET),netbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100417 set_target_defaults = $(call default_opts, \
Brad Smith0fdfe412020-10-08 16:24:52 -0400418 USE_POLL USE_TPROXY USE_THREAD USE_KQUEUE USE_ACCEPT4 USE_CLOSEFROM \
419 USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100420endif
421
422# AIX 5.1 only
Willy Tarreau50abe302014-04-02 20:44:43 +0200423ifeq ($(TARGET),aix51)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100424 set_target_defaults = $(call default_opts, \
Willy Tarreau13d9b022019-03-29 18:56:54 +0100425 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER USE_PRIVATE_CACHE)
Willy Tarreau0aed6ac2019-03-29 18:56:00 +0100426 TARGET_CFLAGS = -Dss_family=__ss_family -Dip6_hdr=ip6hdr -DSTEVENS_API -D_LINUX_SOURCE_COMPAT -Dunsetenv=my_unsetenv
Willy Tarreau50abe302014-04-02 20:44:43 +0200427 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100428endif
429
Christian Lachnerc1322302020-02-10 10:29:13 +0100430# AIX 5.2
Willy Tarreau7dec9652012-06-06 16:15:03 +0200431ifeq ($(TARGET),aix52)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100432 set_target_defaults = $(call default_opts, \
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100433 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER)
Willy Tarreau7dec9652012-06-06 16:15:03 +0200434 TARGET_CFLAGS = -D_MSGQSUPPORT
435 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100436endif
437
Christian Lachnerc1322302020-02-10 10:29:13 +0100438# AIX 7.2 and above
439ifeq ($(TARGET),aix72-gcc)
440 set_target_defaults = $(call default_opts, \
441 USE_POLL USE_THREAD USE_LIBCRYPT USE_OBSOLETE_LINKER USE_GETADDRINFO)
442 TARGET_CFLAGS = -D_H_XMEM -D_H_VAR
443 TARGET_LDFLAGS = -latomic
444endif
445
Willy Tarreau39f19922019-03-27 11:44:19 +0100446# Cygwin
Yitzhak Sapir32087312009-06-14 18:27:54 +0200447ifeq ($(TARGET),cygwin)
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100448 set_target_defaults = $(call default_opts, \
449 USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -0700450 # Cygwin adds IPv6 support only in version 1.7 (in beta right now).
Yitzhak Sapir32087312009-06-14 18:27:54 +0200451 TARGET_CFLAGS = $(if $(filter 1.5.%, $(shell uname -r)), -DUSE_IPV6 -DAF_INET6=23 -DINET6_ADDRSTRLEN=46, )
Willy Tarreau39f19922019-03-27 11:44:19 +0100452endif
willy tarreau4373b962005-12-18 01:32:31 +0100453
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100454# set the default settings according to the target above
455$(set_target_defaults)
456
Willy Tarreaud5d6fdc2021-11-14 15:28:38 +0100457# Some architectures require to link with libatomic for atomics of certain
458# sizes. These ones are reported as value 1 in the *_LOCK_FREE macros. Value
459# 2 indicates that the builtin is native thus doesn't require libatomic. Hence
460# any occurrence of 1 indicates libatomic is necessary. It's better to avoid
461# linking with it by default as it's not always available nor deployed
462# (especially on archs which do not need it).
463ifneq ($(USE_THREAD),)
464ifneq ($(shell $(CC) $(CFLAGS) -dM -E -xc - </dev/null 2>/dev/null | grep -c 'LOCK_FREE.*1'),0)
465 USE_LIBATOMIC=1
466endif
467endif
468
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100469#### Determine version, sub-version and release date.
470# If GIT is found, and IGNOREGIT is not set, VERSION, SUBVERS and VERDATE are
471# extracted from the last commit. Otherwise, use the contents of the files
472# holding the same names in the current directory.
willy tarreau0174f312005-12-18 01:02:42 +0100473
Willy Tarreau6620dbb2007-01-02 00:44:53 +0100474ifeq ($(IGNOREGIT),)
Willy Tarreau3c55efb2019-06-22 08:24:16 +0200475VERSION := $(shell [ -d .git/. ] && (git describe --tags --match 'v*' --abbrev=0 | cut -c 2-) 2>/dev/null)
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100476ifneq ($(VERSION),)
477# OK git is there and works.
Willy Tarreau30a6f642019-06-22 07:51:02 +0200478SUBVERS := $(shell comms=`git log --format=oneline --no-merges v$(VERSION).. 2>/dev/null | wc -l | tr -d '[:space:]'`; commit=`(git log -1 --pretty=%h --abbrev=6) 2>/dev/null`; [ $$comms -gt 0 ] && echo "-$$commit-$$comms")
Willy Tarreau689e4d72013-12-10 09:31:06 +0100479VERDATE := $(shell git log -1 --pretty=format:%ci | cut -f1 -d' ' | tr '-' '/')
Willy Tarreauec692562007-09-09 23:31:11 +0200480endif
481endif
482
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100483# Last commit version not found, take it from the files.
Willy Tarreauec692562007-09-09 23:31:11 +0200484ifeq ($(VERSION),)
485VERSION := $(shell cat VERSION 2>/dev/null || touch VERSION)
486endif
487ifeq ($(SUBVERS),)
Willy Tarreau6173bbe2013-12-16 01:34:39 +0100488SUBVERS := $(shell (grep -v '\$$Format' SUBVERS 2>/dev/null || touch SUBVERS) | head -n 1)
Willy Tarreauec692562007-09-09 23:31:11 +0200489endif
490ifeq ($(VERDATE),)
Willy Tarreauf1ed3272014-01-26 00:39:22 +0100491VERDATE := $(shell (grep -v '^\$$Format' VERDATE 2>/dev/null || touch VERDATE) | head -n 1 | cut -f1 -d' ' | tr '-' '/')
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100492endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100493
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200494# this one is always empty by default and appended verbatim
495EXTRAVERSION =
496
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100497#### Build options
498# Do not change these ones, enable USE_* variables instead.
499OPTIONS_CFLAGS =
500OPTIONS_LDFLAGS =
501OPTIONS_OBJS =
Willy Tarreau77074d52006-11-12 23:57:19 +0100502
Willy Tarreauada5d092019-01-10 10:01:03 +0100503#### Extra objects to be built and integrated (used only for development)
504EXTRA_OBJS =
505
Willy Tarreau09fe5662019-03-27 10:36:35 +0100506# Return USE_xxx=$(USE_xxx) if the variable was set from the environment or the
507# command line.
508# Usage:
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100509# BUILD_OPTIONS += $(call ignore_implicit,USE_xxx)
Willy Tarreau09fe5662019-03-27 10:36:35 +0100510ignore_implicit = $(if $(subst environment,,$(origin $(1))), \
511 $(if $(subst command line,,$(origin $(1))),, \
512 $(1)=$($(1))), \
513 $(1)=$($(1))) \
Willy Tarreau77074d52006-11-12 23:57:19 +0100514
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100515# This variable collects all USE_* values except those set to "implicit". This
516# is used to report a list of all flags which were used to build this version.
517# Do not assign anything to it.
Willy Tarreau7728ed32019-03-27 13:20:08 +0100518BUILD_OPTIONS := $(foreach opt,$(use_opts),$(call ignore_implicit,$(opt)))
519BUILD_FEATURES := $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),+$(opt),-$(opt)))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100520
Willy Tarreau824cd002019-03-27 14:44:14 +0100521# All USE_* options have their equivalent macro defined in the code (some might
522# possibly be unused though)
523OPTIONS_CFLAGS += $(foreach opt,$(use_opts),$(if $($(opt)),-D$(opt),))
524
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100525ifneq ($(USE_LIBCRYPT),)
Matthieu Guegan496374e2020-11-20 10:50:39 +0100526ifneq ($(TARGET),openbsd)
David Carlier6c00eba2019-09-01 14:59:10 +0100527ifneq ($(TARGET),osx)
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100528OPTIONS_LDFLAGS += -lcrypt
529endif
David Carlier6c00eba2019-09-01 14:59:10 +0100530endif
Matthieu Guegan496374e2020-11-20 10:50:39 +0100531endif
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100532
William Lallemand82fe75c2012-10-23 10:25:10 +0200533ifneq ($(USE_ZLIB),)
Willy Tarreaue2f49442012-02-10 20:37:26 +0100534# Use ZLIB_INC and ZLIB_LIB to force path to zlib.h and libz.{a,so} if needed.
535ZLIB_INC =
536ZLIB_LIB =
Willy Tarreau824cd002019-03-27 14:44:14 +0100537OPTIONS_CFLAGS += $(if $(ZLIB_INC),-I$(ZLIB_INC))
Willy Tarreaue2f49442012-02-10 20:37:26 +0100538OPTIONS_LDFLAGS += $(if $(ZLIB_LIB),-L$(ZLIB_LIB)) -lz
William Lallemand82fe75c2012-10-23 10:25:10 +0200539endif
540
Willy Tarreau12840be2021-04-22 14:14:22 +0200541ifneq ($(USE_SLZ),)
542OPTIONS_OBJS += src/slz.o
543endif
544
Willy Tarreau77074d52006-11-12 23:57:19 +0100545ifneq ($(USE_POLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100546OPTIONS_OBJS += src/ev_poll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100547endif
548
549ifneq ($(USE_EPOLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100550OPTIONS_OBJS += src/ev_epoll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100551endif
552
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100553ifneq ($(USE_KQUEUE),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100554OPTIONS_OBJS += src/ev_kqueue.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100555endif
556
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000557ifneq ($(USE_EVPORTS),)
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000558OPTIONS_OBJS += src/ev_evports.o
559endif
560
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100561ifneq ($(USE_DL),)
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100562OPTIONS_LDFLAGS += -ldl
563endif
564
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200565ifneq ($(USE_RT),)
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200566OPTIONS_LDFLAGS += -lrt
567endif
568
Willy Tarreauc0bbdc12020-03-04 08:31:47 +0100569ifneq ($(USE_THREAD),)
570OPTIONS_LDFLAGS += -lpthread
571endif
572
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100573ifneq ($(USE_BACKTRACE),)
574OPTIONS_LDFLAGS += -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic)
575endif
576
Amaury Denoyellef75c6402021-04-14 15:03:51 +0200577ifneq ($(USE_CPU_AFFINITY),)
578OPTIONS_OBJS += src/cpuset.o
579endif
580
Emeric Brun7444f012012-05-18 15:48:30 +0200581ifneq ($(USE_OPENSSL),)
Ilya Shipitsinf21023e2020-08-04 15:36:24 +0500582SSL_INC =
583SSL_LIB =
David CARLIER7385f652015-11-06 15:13:06 +0000584# OpenSSL is packaged in various forms and with various dependencies.
Emeric Brun7444f012012-05-18 15:48:30 +0200585# In general -lssl is enough, but on some platforms, -lcrypto may be needed,
Willy Tarreau8f182d92012-09-10 09:11:22 +0200586# reason why it's added by default. Some even need -lz, then you'll need to
Willy Tarreau9a059452013-09-17 15:26:39 +0200587# pass it in the "ADDLIB" variable if needed. If your SSL libraries are not
588# in the usual path, use SSL_INC=/path/to/inc and SSL_LIB=/path/to/lib.
Willy Tarreau824cd002019-03-27 14:44:14 +0100589OPTIONS_CFLAGS += $(if $(SSL_INC),-I$(SSL_INC))
Willy Tarreaucd360ce2014-10-31 07:36:51 +0100590OPTIONS_LDFLAGS += $(if $(SSL_LIB),-L$(SSL_LIB)) -lssl -lcrypto
Dirkjan Bussink1866d6d2016-08-29 13:26:37 +0200591ifneq ($(USE_DL),)
592OPTIONS_LDFLAGS += -ldl
593endif
William Lallemand6a66a5e2020-05-15 12:01:17 +0200594OPTIONS_OBJS += src/ssl_sample.o src/ssl_sock.o src/ssl_crtlist.o src/ssl_ckch.o src/ssl_utils.o src/cfgparse-ssl.o
William Lallemandb620e982017-11-02 16:00:51 +0100595endif
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100596ifneq ($(USE_QUIC),)
597OPTIONS_OBJS += src/quic_sock.o src/proto_quic.o src/xprt_quic.o src/quic_tls.o \
598 src/quic_frame.o src/quic_cc.o src/quic_cc_newreno.o
599endif
William Lallemandb620e982017-11-02 16:00:51 +0100600
601# The private cache option affect the way the shctx is built
Willy Tarreau824cd002019-03-27 14:44:14 +0100602ifeq ($(USE_PRIVATE_CACHE),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200603ifneq ($(USE_PTHREAD_PSHARED),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200604OPTIONS_LDFLAGS += -lpthread
Emeric Bruncd1a5262014-05-07 23:11:42 +0200605endif
Emeric Brun3e541d12012-09-03 11:14:36 +0200606endif
Olivier Houchard2292edf2019-02-25 14:26:54 +0100607
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100608ifneq ($(USE_LUA),)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100609check_lua_lib = $(shell echo "int main(){}" | $(CC) -o /dev/null -x c - $(2) -l$(1) 2>/dev/null && echo $(1))
Nan Liub286fff2017-06-09 15:57:45 +0800610check_lua_inc = $(shell if [ -d $(2)$(1) ]; then echo $(2)$(1); fi;)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100611
Willy Tarreau824cd002019-03-27 14:44:14 +0100612OPTIONS_CFLAGS += $(if $(LUA_INC),-I$(LUA_INC))
Thierry Fournier13113d62018-02-26 09:25:56 +0100613LUA_LD_FLAGS := -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic) $(if $(LUA_LIB),-L$(LUA_LIB))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100614ifeq ($(LUA_LIB_NAME),)
615# Try to automatically detect the Lua library
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100616LUA_LIB_NAME := $(firstword $(foreach lib,lua5.3 lua53 lua,$(call check_lua_lib,$(lib),$(LUA_LD_FLAGS))))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100617ifeq ($(LUA_LIB_NAME),)
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100618$(error unable to automatically detect the Lua library name, you can enforce its name with LUA_LIB_NAME=<name> (where <name> can be lua5.3, lua53, lua, ...))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100619endif
Nan Liub286fff2017-06-09 15:57:45 +0800620LUA_INC := $(firstword $(foreach lib,lua5.3 lua53 lua,$(call check_lua_inc,$(lib),"/usr/include/")))
621ifneq ($(LUA_INC),)
622OPTIONS_CFLAGS += -I$(LUA_INC)
623endif
Tim Duesterhus541fe1e2020-01-12 13:55:41 +0100624ifneq ($(HLUA_PREPEND_PATH),)
625OPTIONS_CFLAGS += -DHLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
626BUILD_OPTIONS += HLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
627endif
628ifneq ($(HLUA_PREPEND_CPATH),)
629OPTIONS_CFLAGS += -DHLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
630BUILD_OPTIONS += HLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
631endif
Cyril Bontéc21adb52015-03-03 23:13:03 +0100632endif
633
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100634OPTIONS_LDFLAGS += $(LUA_LD_FLAGS) -l$(LUA_LIB_NAME) -lm
Vincent Bernate192cbb2015-07-16 20:52:51 +0200635ifneq ($(USE_DL),)
636OPTIONS_LDFLAGS += -ldl
637endif
Thierry Fournierfb0b5462016-01-21 09:28:58 +0100638OPTIONS_OBJS += src/hlua.o src/hlua_fcn.o
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100639endif
640
Willy Tarreau92dc7862021-04-02 15:31:10 +0200641ifneq ($(USE_PROMEX),)
Willy Tarreau3dfadc72021-04-02 15:35:19 +0200642OPTIONS_OBJS += addons/promex/service-prometheus.o
Willy Tarreau92dc7862021-04-02 15:31:10 +0200643endif
644
David Carliera03fb142015-06-01 14:00:07 +0200645ifneq ($(USE_DEVICEATLAS),)
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200646# Use DEVICEATLAS_SRC and possibly DEVICEATLAS_INC and DEVICEATLAS_LIB to force path
Dragan Dosen93b38d92015-06-29 16:43:25 +0200647# to DeviceAtlas headers and libraries if needed.
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200648DEVICEATLAS_SRC =
649DEVICEATLAS_INC = $(DEVICEATLAS_SRC)
650DEVICEATLAS_LIB = $(DEVICEATLAS_SRC)
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100651ifeq ($(DEVICEATLAS_SRC),)
652OPTIONS_LDFLAGS += -lda
653else
David Carlier019dbd72021-02-16 11:37:45 +0000654ifeq ($(USE_PCRE),)
655ifeq ($(USE_PCRE2),)
656$(error the DeviceAtlas module needs the PCRE or the PCRE2 library in order to compile)
657endif
658endif
659ifneq ($(USE_PCRE2),)
660OPTIONS_CFLAGS += -DDA_REGEX_HDR=\"dac_pcre2.c\" -DDA_REGEX_TAG=2
661endif
David Carliera03fb142015-06-01 14:00:07 +0200662OPTIONS_OBJS += $(DEVICEATLAS_LIB)/json.o
663OPTIONS_OBJS += $(DEVICEATLAS_LIB)/dac.o
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100664endif
Willy Tarreauf8d9ec52021-04-02 16:19:39 +0200665OPTIONS_OBJS += addons/deviceatlas/da.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100666OPTIONS_CFLAGS += $(if $(DEVICEATLAS_INC),-I$(DEVICEATLAS_INC))
David Carliera03fb142015-06-01 14:00:07 +0200667endif
668
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100669ifneq ($(USE_51DEGREES),)
Willy Tarreauc7203c72015-06-01 11:12:35 +0200670# Use 51DEGREES_SRC and possibly 51DEGREES_INC and 51DEGREES_LIB to force path
671# to 51degrees headers and libraries if needed.
67251DEGREES_SRC =
67351DEGREES_INC = $(51DEGREES_SRC)
67451DEGREES_LIB = $(51DEGREES_SRC)
James Rosewell3670eb12015-09-18 17:24:29 +0100675OPTIONS_OBJS += $(51DEGREES_LIB)/../cityhash/city.o
Dragan Dosen93b38d92015-06-29 16:43:25 +0200676OPTIONS_OBJS += $(51DEGREES_LIB)/51Degrees.o
Willy Tarreau977209d2021-04-02 16:12:32 +0200677OPTIONS_OBJS += addons/51degrees/51d.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100678OPTIONS_CFLAGS += $(if $(51DEGREES_INC),-I$(51DEGREES_INC))
Ben51Degrees4ddf59d2019-02-05 13:24:00 +0000679ifeq ($(USE_THREAD),)
680OPTIONS_CFLAGS += -DFIFTYONEDEGREES_NO_THREADING
681else
682OPTIONS_OBJS += $(51DEGREES_LIB)/../threading.o
683endif
684
James Rosewell3670eb12015-09-18 17:24:29 +0100685OPTIONS_LDFLAGS += $(if $(51DEGREES_LIB),-L$(51DEGREES_LIB)) -lm
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100686endif
687
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200688ifneq ($(USE_WURFL),)
689# Use WURFL_SRC and possibly WURFL_INC and WURFL_LIB to force path
690# to WURFL headers and libraries if needed.
691WURFL_SRC =
692WURFL_INC = $(WURFL_SRC)
693WURFL_LIB = $(WURFL_SRC)
Willy Tarreau57610c62021-04-02 16:39:44 +0200694OPTIONS_OBJS += addons/wurfl/wurfl.o
Willy Tarreau14261982019-04-23 10:57:09 +0200695OPTIONS_CFLAGS += $(if $(WURFL_INC),-I$(WURFL_INC))
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200696ifneq ($(WURFL_DEBUG),)
697OPTIONS_CFLAGS += -DWURFL_DEBUG
698endif
699ifneq ($(WURFL_HEADER_WITH_DETAILS),)
700OPTIONS_CFLAGS += -DWURFL_HEADER_WITH_DETAILS
701endif
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200702OPTIONS_LDFLAGS += $(if $(WURFL_LIB),-L$(WURFL_LIB)) -lwurfl
703endif
704
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100705ifneq ($(USE_SYSTEMD),)
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100706OPTIONS_LDFLAGS += -lsystemd
707endif
708
Hiroaki Nakamura70351322013-01-13 15:00:42 +0900709ifneq ($(USE_PCRE)$(USE_STATIC_PCRE)$(USE_PCRE_JIT),)
David Carlierf2592b22016-11-21 21:25:58 +0000710ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
711$(error cannot compile both PCRE and PCRE2 support)
712endif
Willy Tarreau39793092013-02-13 12:39:06 +0100713# PCREDIR is used to automatically construct the PCRE_INC and PCRE_LIB paths,
714# by appending /include and /lib respectively. If your system does not use the
715# same sub-directories, simply force these variables instead of PCREDIR. It is
716# automatically detected but can be forced if required (for cross-compiling).
717# Forcing PCREDIR to an empty string will let the compiler use the default
718# locations.
719
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200720PCRE_CONFIG := pcre-config
721PCREDIR := $(shell $(PCRE_CONFIG) --prefix 2>/dev/null || echo /usr/local)
Willy Tarreau39793092013-02-13 12:39:06 +0100722ifneq ($(PCREDIR),)
723PCRE_INC := $(PCREDIR)/include
724PCRE_LIB := $(PCREDIR)/lib
Willy Tarreau79b34bf2006-12-22 15:28:43 +0100725endif
Willy Tarreau39793092013-02-13 12:39:06 +0100726
Christian Wiesec8203002008-11-20 14:47:04 +0100727ifeq ($(USE_STATIC_PCRE),)
Willy Tarreau39793092013-02-13 12:39:06 +0100728# dynamic PCRE
729OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
730OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -lpcreposix -lpcre
Willy Tarreau39793092013-02-13 12:39:06 +0100731else
732# static PCRE
733OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
734OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -Wl,-Bstatic -lpcreposix -lpcre -Wl,-Bdynamic
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100735endif
Willy Tarreau39793092013-02-13 12:39:06 +0100736endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100737
David Carlierf2592b22016-11-21 21:25:58 +0000738ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200739PCRE2_CONFIG := pcre2-config
740PCRE2DIR := $(shell $(PCRE2_CONFIG) --prefix 2>/dev/null || echo /usr/local)
David Carlierf2592b22016-11-21 21:25:58 +0000741ifneq ($(PCRE2DIR),)
742PCRE2_INC := $(PCRE2DIR)/include
743PCRE2_LIB := $(PCRE2DIR)/lib
744
745ifeq ($(PCRE2_WIDTH),)
746PCRE2_WIDTH = 8
747endif
748
749ifneq ($(PCRE2_WIDTH),8)
750ifneq ($(PCRE2_WIDTH),16)
751ifneq ($(PCRE2_WIDTH),32)
752$(error PCRE2_WIDTH needs to be set to either 8,16 or 32)
753endif
754endif
755endif
756
757
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200758PCRE2_LDFLAGS := $(shell $(PCRE2_CONFIG) --libs$(PCRE2_WIDTH) 2>/dev/null || echo -L/usr/local/lib -lpcre2-$(PCRE2_WIDTH))
David Carlierf2592b22016-11-21 21:25:58 +0000759
760ifeq ($(PCRE2_LDFLAGS),)
761$(error libpcre2-$(PCRE2_WIDTH) not found)
762else
763ifeq ($(PCRE2_WIDTH),8)
764PCRE2_LDFLAGS += -lpcre2-posix
765endif
766endif
767
768OPTIONS_CFLAGS += -DUSE_PCRE2 -DPCRE2_CODE_UNIT_WIDTH=$(PCRE2_WIDTH)
769OPTIONS_CFLAGS += $(if $(PCRE2_INC), -I$(PCRE2_INC))
770
771ifneq ($(USE_STATIC_PCRE2),)
772OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -Wl,-Bstatic -L$(PCRE2_LIB) $(PCRE2_LDFLAGS) -Wl,-Bdynamic
David Carlierf2592b22016-11-21 21:25:58 +0000773else
774OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -L$(PCRE2_LIB) $(PCRE2_LDFLAGS)
David Carlierf2592b22016-11-21 21:25:58 +0000775endif
776
David Carlierf2592b22016-11-21 21:25:58 +0000777endif
778endif
779
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100780#### Global compile options
781VERBOSE_CFLAGS = $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE)
Willy Tarreaufc80e302020-05-27 11:05:33 +0200782COPTS = -Iinclude
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200783
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100784COPTS += $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE) $(SILENT_DEFINE)
785COPTS += $(DEBUG) $(OPTIONS_CFLAGS) $(ADDINC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100786
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200787ifneq ($(VERSION)$(SUBVERS)$(EXTRAVERSION),)
788COPTS += -DCONFIG_HAPROXY_VERSION=\"$(VERSION)$(SUBVERS)$(EXTRAVERSION)\"
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100789endif
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100790
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100791ifneq ($(VERDATE),)
792COPTS += -DCONFIG_HAPROXY_DATE=\"$(VERDATE)\"
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100793endif
794
Willy Tarreau7de211c2012-05-25 23:53:16 +0200795ifneq ($(TRACE),)
796# if tracing is enabled, we want it to be as fast as possible
797TRACE_COPTS := $(filter-out -O0 -O1 -O2 -pg -finstrument-functions,$(COPTS)) -O3 -fomit-frame-pointer
798COPTS += -finstrument-functions
799endif
800
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100801ifneq ($(USE_NS),)
Willy Tarreau7520e4f2018-11-11 14:38:09 +0100802OPTIONS_OBJS += src/namespace.o
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100803endif
804
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100805ifneq ($(USE_OT),)
Willy Tarreaua63d1a02021-04-02 17:16:46 +0200806include addons/ot/Makefile
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100807endif
808
Willy Tarreaud5d6fdc2021-11-14 15:28:38 +0100809ifneq ($(USE_LIBATOMIC),)
810 TARGET_LDFLAGS += -latomic
811endif
812
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100813#### Global link options
814# These options are added at the end of the "ld" command line. Use LDFLAGS to
815# add options at the beginning of the "ld" command line if needed.
816LDOPTS = $(TARGET_LDFLAGS) $(OPTIONS_LDFLAGS) $(ADDLIB)
willy tarreau0f7af912005-12-17 12:21:26 +0100817
Willy Tarreau16119652018-11-19 08:15:54 +0100818ifeq ($V,1)
819cmd_CC = $(CC)
820cmd_LD = $(LD)
821cmd_AR = $(AR)
822else
823cmd_CC = $(Q)echo " CC $@";$(CC)
824cmd_LD = $(Q)echo " LD $@";$(LD)
825cmd_AR = $(Q)echo " AR $@";$(AR)
826endif
827
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100828ifeq ($(TARGET),)
829all:
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100830 @echo "Building HAProxy without specifying a TARGET is not supported."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100831 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100832 @echo "Usage:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100833 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100834 @echo " $ make help # To print a full explanation."
835 @echo " $ make TARGET=xxx USE_<feature>=1 # To build HAProxy."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100836 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100837 @echo "The most commonly used targets are:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100838 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100839 @echo " linux-glibc - Modern Linux with glibc"
840 @echo " linux-musl - Modern Linux with musl"
841 @echo " freebsd - FreeBSD"
842 @echo " openbsd - OpenBSD"
843 @echo " netbsd - NetBSD"
844 @echo " osx - macOS"
845 @echo " solaris - Solaris"
846 @echo
847 @echo "Choose the target which matches your OS the most in order to"
848 @echo "gain the maximum performance out of it."
849 @echo
850 @echo "Common features you might want to include in your build are:"
851 @echo
852 @echo " USE_OPENSSL=1 - Support for TLS encrypted connections"
853 @echo " USE_ZLIB=1 - Support for HTTP response compression"
854 @echo " USE_PCRE=1 - Support for PCRE regular expressions"
855 @echo " USE_LUA=1 - Support for dynamic processing using Lua"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100856 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100857 @echo "Use 'make help' to print a full explanation of supported targets"
858 @echo "and features."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100859 @echo
860 @exit 1
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200861else
862ifneq ($(filter $(TARGET), linux linux22 linux24 linux24e linux26 linux2628),)
Willy Tarreau99e49e92019-06-14 16:44:49 +0200863all:
864 @echo
865 @echo "Target '$(TARGET)' was removed from HAProxy 2.0 due to being irrelevant and"
866 @echo "often wrong. Please use 'linux-glibc' instead or define your custom target"
867 @echo "by checking available options using 'make help TARGET=<your-target>'."
868 @echo
869 @exit 1
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100870else
Willy Tarreau888bda02021-04-02 13:59:17 +0200871all: haproxy dev/flags/flags $(EXTRA)
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100872endif
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200873endif
willy tarreau0f7af912005-12-17 12:21:26 +0100874
Willy Tarreau2404e372020-11-05 16:42:25 +0100875OBJS =
Willy Tarreau7de211c2012-05-25 23:53:16 +0200876
Willy Tarreauada5d092019-01-10 10:01:03 +0100877ifneq ($(EXTRA_OBJS),)
878OBJS += $(EXTRA_OBJS)
879endif
Marc-Antoine Perennoued9803e2013-02-12 10:53:53 +0100880
Willy Tarreau1d142622021-05-08 23:33:25 +0200881OBJS += src/mux_h2.o src/mux_fcgi.o src/http_ana.o src/mux_h1.o src/stream.o \
882 src/tcpcheck.o src/stats.o src/flt_spoe.o src/server.o src/tools.o \
883 src/sample.o src/log.o src/backend.o src/stick_table.o src/cfgparse.o \
884 src/peers.o src/cli.o src/pattern.o src/resolvers.o src/proxy.o \
885 src/http_htx.o src/check.o src/cache.o src/cfgparse-listen.o \
886 src/haproxy.o src/http_act.o src/stream_interface.o src/http_fetch.o \
887 src/listener.o src/dns.o src/connection.o src/tcp_rules.o src/debug.o \
888 src/sink.o src/payload.o src/mux_pt.o src/filters.o src/fcgi-app.o \
889 src/server_state.o src/vars.o src/map.o src/cfgparse-global.o \
890 src/task.o src/flt_http_comp.o src/session.o src/sock.o \
891 src/flt_trace.o src/acl.o src/trace.o src/http_rules.o src/queue.o \
892 src/mjson.o src/h2.o src/h1.o src/mworker.o src/lb_chash.o src/ring.o \
893 src/activity.o src/tcp_sample.o src/proto_tcp.o src/htx.o src/h1_htx.o \
894 src/extcheck.o src/channel.o src/proto_sockpair.o src/fd.o \
895 src/compression.o src/mqtt.o src/tcp_act.o src/raw_sock.o \
896 src/frontend.o src/http_conv.o src/xprt_handshake.o src/pool.o \
897 src/applet.o src/mailers.o src/lb_fwrr.o src/lb_fwlc.o src/lb_fas.o \
898 src/proto_uxst.o src/http.o src/action.o src/protocol.o src/thread.o \
899 src/sock_unix.o src/proto_udp.o src/lb_map.o src/sock_inet.o src/lru.o \
900 src/cfgparse-tcp.o src/cfgdiag.o src/proto_uxdg.o src/ev_select.o \
901 src/cfgparse-unix.o src/uri_normalizer.o src/ebmbtree.o src/sha1.o \
902 src/time.o src/signal.o src/mworker-prog.o src/hpack-dec.o src/fix.o \
903 src/arg.o src/eb64tree.o src/chunk.o src/shctx.o src/regex.o \
904 src/fcgi.o src/eb32tree.o src/eb32sctree.o src/dynbuf.o src/uri_auth.o \
905 src/hpack-tbl.o src/ebimtree.o src/auth.o src/ebsttree.o \
906 src/ebistree.o src/base64.o src/wdt.o src/pipe.o src/http_acl.o \
907 src/hpack-enc.o src/dict.o src/dgram.o src/init.o src/hpack-huff.o \
908 src/freq_ctr.o src/ebtree.o src/hash.o src/version.o
Willy Tarreau2404e372020-11-05 16:42:25 +0100909
910ifneq ($(TRACE),)
911OBJS += src/calltrace.o
912endif
913
Willy Tarreaub26835d2016-05-30 13:39:32 +0200914# Used only for forced dependency checking. May be cleared during development.
Willy Tarreaufc80e302020-05-27 11:05:33 +0200915INCLUDES = $(wildcard include/*/*.h)
Willy Tarreau8225bb42016-05-30 15:16:10 +0200916DEP = $(INCLUDES) .build_opts
917
William Lallemandf1b60f72018-12-13 14:02:25 +0100918help:
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000919 @sed -ne "/^[^#]*$$/q;s/^# \{0,1\}\(.*\)/\1/;p" Makefile
920 @echo; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200921 if [ -n "$(TARGET)" ]; then \
Willy Tarreau5fb76032019-06-16 19:26:18 +0200922 if [ -n "$(set_target_defaults)" ]; then \
923 echo "Current TARGET: $(TARGET)"; \
924 else \
925 echo "Current TARGET: $(TARGET) (custom target)"; \
926 fi; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200927 else \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200928 echo "TARGET not set, you may pass 'TARGET=xxx' to set one among :";\
Brad Smith382001b2020-10-08 01:15:06 -0400929 echo " linux-glibc, linux-glibc-legacy, solaris, freebsd, dragonfly, netbsd,"; \
930 echo " osx, openbsd, aix51, aix52, aix72-gcc, cygwin, haiku, generic,"; \
931 echo " custom"; \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200932 fi
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000933 @echo;echo "Enabled features for TARGET '$(TARGET)' (disable with 'USE_xxx=') :"
934 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),$(opt),)); echo " $$*" | (fmt || cat) 2>/dev/null
935 @echo;echo "Disabled features for TARGET '$(TARGET)' (enable with 'USE_xxx=1') :"
936 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),,$(opt))); echo " $$*" | (fmt || cat) 2>/dev/null
William Lallemandf1b60f72018-12-13 14:02:25 +0100937
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100938# Used only to force a rebuild if some build options change, but we don't do
939# it for certain targets which take no build options
940ifneq (reg-tests, $(firstword $(MAKECMDGOALS)))
Tim Duesterhus81e948e2020-11-21 18:07:58 +0100941build_opts = $(shell rm -f .build_opts.new; echo \'$(TARGET) $(BUILD_OPTIONS) $(VERBOSE_CFLAGS) $(DEBUG)\' > .build_opts.new; if cmp -s .build_opts .build_opts.new; then rm -f .build_opts.new; else mv -f .build_opts.new .build_opts; fi)
Willy Tarreau509a0092019-03-29 17:17:52 +0100942.build_opts: $(build_opts)
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100943else
944.build_opts:
945endif
Willy Tarreaub26835d2016-05-30 13:39:32 +0200946
Willy Tarreauff0e8a42020-05-27 10:43:24 +0200947haproxy: $(OPTIONS_OBJS) $(OBJS)
Willy Tarreau16119652018-11-19 08:15:54 +0100948 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
willy tarreau0f7af912005-12-17 12:21:26 +0100949
Willy Tarreaubaaee002006-06-26 02:48:02 +0200950objsize: haproxy
Willy Tarreaub42233a2018-11-19 07:44:42 +0100951 $(Q)objdump -t $^|grep ' g '|grep -F '.text'|awk '{print $$5 FS $$6}'|sort
Willy Tarreaubaaee002006-06-26 02:48:02 +0200952
Willy Tarreaub26835d2016-05-30 13:39:32 +0200953%.o: %.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100954 $(cmd_CC) $(COPTS) -c -o $@ $<
willy tarreau0f7af912005-12-17 12:21:26 +0100955
Willy Tarreaua9f16c62021-04-02 14:46:21 +0200956admin/halog/halog: admin/halog/halog.o admin/halog/fgets2.o src/ebtree.o src/eb32tree.o src/eb64tree.o src/ebmbtree.o src/ebsttree.o src/ebistree.o src/ebimtree.o
957 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200958
Willy Tarreau8f72d482021-08-11 13:54:52 +0200959admin/dyncookie/dyncookie: admin/dyncookie/dyncookie.o
960 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
961
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200962dev/flags/flags: dev/flags/flags.o
963 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200964
Willy Tarreau21ef8b92021-04-02 14:27:26 +0200965dev/hpack/%: dev/hpack/%.o
966 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
967
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200968dev/poll/poll:
969 $(Q)$(MAKE) -C dev/poll poll CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200970
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200971dev/tcploop/tcploop:
972 $(Q)$(MAKE) -C dev/tcploop tcploop CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200973
Willy Tarreau909b9d82019-01-04 18:20:32 +0100974# rebuild it every time
975.PHONY: src/version.c
976
Willy Tarreau9eebd8a2019-08-08 16:53:40 +0200977src/calltrace.o: src/calltrace.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100978 $(cmd_CC) $(TRACE_COPTS) -c -o $@ $<
Willy Tarreau7de211c2012-05-25 23:53:16 +0200979
Willy Tarreaub26835d2016-05-30 13:39:32 +0200980src/haproxy.o: src/haproxy.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100981 $(cmd_CC) $(COPTS) \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100982 -DBUILD_TARGET='"$(strip $(TARGET))"' \
Willy Tarreauef7341d2009-04-11 19:45:50 +0200983 -DBUILD_ARCH='"$(strip $(ARCH))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100984 -DBUILD_CPU='"$(strip $(CPU))"' \
985 -DBUILD_CC='"$(strip $(CC))"' \
986 -DBUILD_CFLAGS='"$(strip $(VERBOSE_CFLAGS))"' \
987 -DBUILD_OPTIONS='"$(strip $(BUILD_OPTIONS))"' \
Tim Duesterhusc8d19702020-11-21 18:07:59 +0100988 -DBUILD_DEBUG='"$(strip $(DEBUG))"' \
Willy Tarreau7728ed32019-03-27 13:20:08 +0100989 -DBUILD_FEATURES='"$(strip $(BUILD_FEATURES))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100990 -c -o $@ $<
Willy Tarreau7b066db2007-12-02 11:28:59 +0100991
Christian Wiese19b50292008-03-12 15:57:54 +0200992install-man:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100993 $(Q)install -v -d "$(DESTDIR)$(MANDIR)"/man1
994 $(Q)install -v -m 644 doc/haproxy.1 "$(DESTDIR)$(MANDIR)"/man1
Christian Wiese19b50292008-03-12 15:57:54 +0200995
Vincent Bernat5c5147f2015-10-13 22:20:55 +0200996EXCLUDE_DOCUMENTATION = lgpl gpl coding-style
997DOCUMENTATION = $(filter-out $(EXCLUDE_DOCUMENTATION),$(patsubst doc/%.txt,%,$(wildcard doc/*.txt)))
998
Christian Wiesebf34eb42008-03-12 17:24:49 +0200999install-doc:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001000 $(Q)install -v -d "$(DESTDIR)$(DOCDIR)"
1001 $(Q)for x in $(DOCUMENTATION); do \
1002 install -v -m 644 doc/$$x.txt "$(DESTDIR)$(DOCDIR)" ; \
Christian Wiesebf34eb42008-03-12 17:24:49 +02001003 done
1004
Willy Tarreau13d67bb2016-06-24 18:30:22 +02001005install-bin:
Willy Tarreaub42233a2018-11-19 07:44:42 +01001006 $(Q)for i in haproxy $(EXTRA); do \
Willy Tarreau13d67bb2016-06-24 18:30:22 +02001007 if ! [ -e "$$i" ]; then \
1008 echo "Please run 'make' before 'make install'."; \
1009 exit 1; \
1010 fi; \
1011 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001012 $(Q)install -v -d "$(DESTDIR)$(SBINDIR)"
1013 $(Q)install -v haproxy $(EXTRA) "$(DESTDIR)$(SBINDIR)"
Christian Wiesea184aa22008-03-12 15:25:35 +02001014
Christian Wiesedb5238d2008-03-12 18:28:13 +02001015install: install-bin install-man install-doc
Christian Wiese4cf5d572008-03-12 16:21:05 +02001016
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001017uninstall:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001018 $(Q)rm -f "$(DESTDIR)$(MANDIR)"/man1/haproxy.1
1019 $(Q)for x in $(DOCUMENTATION); do \
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001020 rm -f "$(DESTDIR)$(DOCDIR)"/$$x.txt ; \
1021 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001022 $(Q)-rmdir "$(DESTDIR)$(DOCDIR)"
1023 $(Q)rm -f "$(DESTDIR)$(SBINDIR)"/haproxy
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001024
willy tarreau0f7af912005-12-17 12:21:26 +01001025clean:
Willy Tarreauff0e8a42020-05-27 10:43:24 +02001026 $(Q)rm -f *.[oas] src/*.[oas] haproxy test .build_opts .build_opts.new
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001027 $(Q)for dir in . src dev/* admin/* addons/* include/* doc; do rm -f $$dir/*~ $$dir/*.rej $$dir/core; done
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001028 $(Q)rm -f haproxy-$(VERSION).tar.gz haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1029 $(Q)rm -f haproxy-$(VERSION) haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) nohup.out gmon.out
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001030 $(Q)rm -f addons/promex/*.[oas]
Willy Tarreau977209d2021-04-02 16:12:32 +02001031 $(Q)rm -f addons/51degrees/*.[oas] addons/51degrees/dummy/*.[oas] addons/51degrees/dummy/*/*.[oas]
Willy Tarreauf8d9ec52021-04-02 16:19:39 +02001032 $(Q)rm -f addons/deviceatlas/*.[oas] addons/deviceatlas/dummy/*.[oas]
Willy Tarreaua63d1a02021-04-02 17:16:46 +02001033 $(Q)rm -f addons/ot/src/*.[oas]
Willy Tarreau57610c62021-04-02 16:39:44 +02001034 $(Q)rm -f addons/wurfl/*.[oas] addons/wurfl/dummy/*.[oas]
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001035 $(Q)rm -f admin/*/*.[oas] admin/*/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001036 $(Q)rm -f admin/iprange/iprange admin/iprange/ip6range admin/halog/halog
Willy Tarreau8f72d482021-08-11 13:54:52 +02001037 $(Q)rm -f admin/dyncookie/dyncookie
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001038 $(Q)rm -f dev/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001039 $(Q)rm -f dev/flags/flags dev/poll/poll dev/tcploop/tcploop
Willy Tarreau21ef8b92021-04-02 14:27:26 +02001040 $(Q)rm -f dev/hpack/decode dev/hpack/gen-enc dev/hpack/gen-rht
willy tarreauefae1842005-12-17 12:51:03 +01001041
Willy Tarreauebe0af42009-10-10 22:20:44 +02001042tags:
Willy Tarreau6db82662018-11-19 08:14:40 +01001043 $(Q)find src include \( -name '*.c' -o -name '*.h' \) -print0 | \
Willy Tarreauebe0af42009-10-10 22:20:44 +02001044 xargs -0 etags --declarations --members
1045
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001046cscope:
Willy Tarreau6db82662018-11-19 08:14:40 +01001047 $(Q)find src include -name "*.[ch]" -print | cscope -q -b -i -
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001048
willy tarreaue114bf92006-03-19 21:30:14 +01001049tar: clean
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001050 $(Q)ln -s . haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
1051 $(Q)tar --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/.git \
1052 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) \
1053 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz \
1054 -cf - haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/* | gzip -c9 >haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1055 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1056 $(Q)rm -f haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
willy tarreaucee272f2006-03-19 21:16:26 +01001057
Willy Tarreau05ed29c2012-12-20 15:00:44 +01001058git-tar:
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001059 $(Q)git archive --format=tar --prefix="haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/" HEAD | gzip -9 > haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1060 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
Willy Tarreauec692562007-09-09 23:31:11 +02001061
1062version:
1063 @echo "VERSION: $(VERSION)"
1064 @echo "SUBVERS: $(SUBVERS)"
1065 @echo "VERDATE: $(VERDATE)"
1066
1067# never use this one if you don't know what it is used for.
1068update-version:
1069 @echo "Ready to update the following versions :"
1070 @echo "VERSION: $(VERSION)"
1071 @echo "SUBVERS: $(SUBVERS)"
1072 @echo "VERDATE: $(VERDATE)"
1073 @echo "Press [ENTER] to continue or Ctrl-C to abort now.";read
1074 echo "$(VERSION)" > VERSION
1075 echo "$(SUBVERS)" > SUBVERS
1076 echo "$(VERDATE)" > VERDATE
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001077
Willy Tarreaua8b12c62018-10-03 09:40:22 +02001078# just display the build options
1079opts:
1080 @echo -n 'Using: '
1081 @echo -n 'TARGET="$(strip $(TARGET))" '
1082 @echo -n 'ARCH="$(strip $(ARCH))" '
1083 @echo -n 'CPU="$(strip $(CPU))" '
1084 @echo -n 'CC="$(strip $(CC))" '
1085 @echo -n 'ARCH_FLAGS="$(strip $(ARCH_FLAGS))" '
1086 @echo -n 'CPU_CFLAGS="$(strip $(CPU_CFLAGS))" '
1087 @echo -n 'DEBUG_CFLAGS="$(strip $(DEBUG_CFLAGS))" '
1088 @echo "$(strip $(BUILD_OPTIONS))"
1089 @echo 'COPTS="$(strip $(COPTS))"'
1090 @echo 'LDFLAGS="$(strip $(LDFLAGS))"'
1091 @echo 'LDOPTS="$(strip $(LDOPTS))"'
1092 @echo 'OPTIONS_OBJS="$(strip $(OPTIONS_OBJS))"'
1093 @echo 'OBJS="$(strip $(OBJS))"'
1094
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001095ifeq (reg-tests, $(firstword $(MAKECMDGOALS)))
1096 REGTEST_ARGS := $(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))
1097 $(eval $(REGTEST_ARGS):;@true)
1098endif
1099
Frédéric Lécaille99316342018-08-22 10:41:33 +02001100# Target to run the regression testing script files.
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001101reg-tests:
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001102 $(Q)$(REG_TEST_SCRIPT) --type "$(REGTESTS_TYPES)" $(REGTEST_ARGS) $(REG_TEST_FILES)
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001103.PHONY: $(REGTEST_ARGS)
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001104
1105reg-tests-help:
1106 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001107 @echo "To launch the reg tests for haproxy, first export to your environment "
1108 @echo "VTEST_PROGRAM variable to point to your vtest program:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001109 @echo " $$ export VTEST_PROGRAM=/opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001110 @echo "or"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001111 @echo " $$ setenv VTEST_PROGRAM /opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001112 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001113 @echo "The same thing may be done to set your haproxy program with HAPROXY_PROGRAM "
1114 @echo "but with ./haproxy as default value."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001115 @echo
1116 @echo "To run all the tests:"
1117 @echo " $$ make reg-tests"
1118 @echo
1119 @echo "You can also set the programs to be used on the command line:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001120 @echo " $$ VTEST_PROGRAM=<...> HAPROXY_PROGRAM=<...> make reg-tests"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001121 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001122 @echo "To run tests with specific types:"
1123 @echo " $$ REGTESTS_TYPES=slow,default make reg-tests"
1124 @echo
William Lallemandc1ddcaf2021-02-05 11:27:54 +01001125 @echo "with 'default,bug,devel,slow' as default value for REGTESTS_TYPES variable."
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001126 @echo
1127 @echo "About the reg test types:"
1128 @echo " any : all the tests without distinction (this is the default"
1129 @echo " value of REGTESTS_TYPES."
1130 @echo " default : dedicated to pure haproxy compliance tests."
1131 @echo " slow : scripts which take non negligible time to run."
1132 @echo " bug : scripts in relation with bugs they help to reproduce."
1133 @echo " broken : scripts triggering known broken behaviors for which"
1134 @echo " there is still no fix."
1135 @echo " experimental: for scripts which are experimental, typically used to"
1136 @echo " develop new scripts."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001137 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001138 @echo "Note that 'reg-tests' target run '"$(REG_TEST_SCRIPT)"' script"
1139 @echo "(see --help option of this script for more information)."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001140
1141.PHONY: reg-tests reg-tests-help