blob: 158daefb3b7b5e1116e59bb46b2b527ac7ce7269 [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.
Willy Tarreau12840be2021-04-22 14:14:22 +020042# USE_ZLIB : enable zlib library support and disable SLZ
43# USE_SLZ : enable slz library instead of zlib (default=enabled)
Willy Tarreaufc6c0322012-11-16 16:12:27 +010044# USE_CPU_AFFINITY : enable pinning processes to CPU on Linux. Automatic.
Lukas Tribus0999f762013-04-02 16:43:24 +020045# USE_TFO : enable TCP fast open. Supported on Linux >= 3.7.
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +010046# USE_NS : enable network namespace support. Supported on Linux >= 2.6.24.
Willy Tarreau71b99ef2015-03-17 14:33:22 +010047# USE_DL : enable it if your system requires -ldl. Automatic on Linux.
Willy Tarreau58e90cb2018-10-18 16:28:54 +020048# USE_RT : enable it if your system requires -lrt. Automatic on Linux.
Willy Tarreauf5b4e062020-03-03 15:40:23 +010049# USE_BACKTRACE : enable backtrace(). Automatic on Linux.
Willy Tarreau92dc7862021-04-02 15:31:10 +020050# USE_PROMEX : enable the Prometheus exporter
David Carliera03fb142015-06-01 14:00:07 +020051# USE_DEVICEATLAS : enable DeviceAtlas api.
Dragan Dosen93b38d92015-06-29 16:43:25 +020052# USE_51DEGREES : enable third party device detection library from 51Degrees
Willy Tarreaub3cc9f22019-04-19 16:03:32 +020053# USE_WURFL : enable WURFL detection library from Scientiamobile
Tim Duesterhusd6942c82017-11-20 15:58:35 +010054# USE_SYSTEMD : enable sd_notify() support.
Willy Tarreau7b5654f2019-03-29 21:30:17 +010055# USE_OBSOLETE_LINKER : use when the linker fails to emit __start_init/__stop_init
Willy Tarreauc7091d82019-05-17 10:08:49 +020056# USE_THREAD_DUMP : use the more advanced thread state dump system. Automatic.
Miroslav Zagorac70230c62020-12-09 16:54:31 +010057# USE_OT : enable the OpenTracing filter
Willy Tarreauf6818d62021-05-05 18:17:39 +020058# USE_MEMORY_PROFILING : enable the memory profiler. Linux-glibc only.
Willy Tarreauf2ef8c52007-07-11 09:19:31 +020059#
Willy Tarreau9f2b7302008-01-02 20:48:34 +010060# Options can be forced by specifying "USE_xxx=1" or can be disabled by using
Willy Tarreau50b1aae2019-06-14 15:52:01 +020061# "USE_xxx=" (empty string). The list of enabled and disabled options for a
62# given TARGET is enumerated at the end of "make help".
Willy Tarreau9f2b7302008-01-02 20:48:34 +010063#
64# Variables useful for packagers :
Brad Smith94636432020-09-13 02:53:06 -040065# CC is set to "cc" by default and is used for compilation only.
66# LD is set to "cc" by default and is used for linking only.
Willy Tarreauef7341d2009-04-11 19:45:50 +020067# ARCH may be useful to force build of 32-bit binary on 64-bit systems
Willy Tarreau9f2b7302008-01-02 20:48:34 +010068# CFLAGS is automatically set for the specified CPU and may be overridden.
69# LDFLAGS is automatically set to -g and may be overridden.
Willy Tarreaub26835d2016-05-30 13:39:32 +020070# DEP may be cleared to ignore changes to include files during development
Willy Tarreau9f2b7302008-01-02 20:48:34 +010071# SMALL_OPTS may be used to specify some options to shrink memory usage.
72# DEBUG may be used to set some internal debugging options.
Willy Tarreau23cd43e2018-10-22 06:22:46 +020073# ERR may be set to non-empty to pass -Werror to the compiler
Willy Tarreau9f2b7302008-01-02 20:48:34 +010074# ADDINC may be used to complete the include path in the form -Ipath.
75# ADDLIB may be used to complete the library list in the form -Lpath -llib.
76# DEFINE may be used to specify any additional define, which will be reported
77# by "haproxy -vv" in CFLAGS.
78# SILENT_DEFINE may be used to specify other defines which will not be
79# reported by "haproxy -vv".
William Lallemanda6cfa902017-06-01 17:38:58 +020080# EXTRA is used to force building or not building some extra tools.
Christian Wiesea184aa22008-03-12 15:25:35 +020081# DESTDIR is not set by default and is used for installation only.
82# It might be useful to set DESTDIR if you want to install haproxy
83# in a sandbox.
84# PREFIX is set to "/usr/local" by default and is used for installation only.
85# SBINDIR is set to "$(PREFIX)/sbin" by default and is used for installation
86# only.
Christian Wiese19b50292008-03-12 15:57:54 +020087# MANDIR is set to "$(PREFIX)/share/man" by default and is used for
88# installation only.
Christian Wiesebf34eb42008-03-12 17:24:49 +020089# DOCDIR is set to "$(PREFIX)/doc/haproxy" by default and is used for
90# installation only.
Tim Duesterhus541fe1e2020-01-12 13:55:41 +010091# HLUA_PREPEND_PATH may be used to prepend a folder to Lua's default package.path.
92# HLUA_PREPEND_CPATH may be used to prepend a folder to Lua's default package.cpath.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010093#
94# Other variables :
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +020095# PCRE_CONFIG : force the binary path to get pcre config (by default
96# pcre-config)
Willy Tarreau9f2b7302008-01-02 20:48:34 +010097# PCREDIR : force the path to libpcre.
Willy Tarreau39793092013-02-13 12:39:06 +010098# PCRE_LIB : force the lib path to libpcre (defaults to $PCREDIR/lib).
99# PCRE_INC : force the include path to libpcre ($PCREDIR/inc)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200100# PCRE2_CONFIG : force the binary path to get pcre2 config (by default
101# pcre2-config)
Willy Tarreau9a059452013-09-17 15:26:39 +0200102# SSL_LIB : force the lib path to libssl/libcrypto
103# SSL_INC : force the include path to libssl/libcrypto
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100104# LUA_LIB : force the lib path to lua
105# LUA_INC : force the include path to lua
Cyril Bontéc21adb52015-03-03 23:13:03 +0100106# LUA_LIB_NAME : force the lib name (or automatically evaluated, by order of
Thierry FOURNIERf90838b2015-03-06 13:48:32 +0100107# priority : lua5.3, lua53, lua).
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100108# OT_DEBUG : compile the OpenTracing filter in debug mode
109# OT_INC : force the include path to libopentracing-c-wrapper
110# OT_LIB : force the lib path to libopentracing-c-wrapper
111# OT_RUNPATH : add RUNPATH for libopentracing-c-wrapper to haproxy executable
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100112# IGNOREGIT : ignore GIT commit versions if set.
113# VERSION : force haproxy version reporting.
114# SUBVERS : add a sub-version (eg: platform, model, ...).
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200115# EXTRAVERSION : local version string to append (e.g. build number etc)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100116# VERDATE : force haproxy's release date.
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200117# VTEST_PROGRAM : location of the vtest program to run reg-tests.
Ilya Shipitsin4a034f22020-09-12 11:24:48 +0500118# DEBUG_USE_ABORT: use abort() for program termination, see include/haproxy/bug.h for details
Willy Tarreau4f60f162007-04-08 16:39:58 +0200119
Willy Tarreaub42233a2018-11-19 07:44:42 +0100120# verbosity: pass V=1 for verbose shell invocation
121V = 0
122Q = @
123ifeq ($V,1)
124Q=
125endif
126
Christopher Faulet16150642021-04-14 14:02:56 +0200127# WARNING: Do not change cc-opt, cc-opt-alt or cc-warning without checking if
128# clang bug #49364 is fixed. stderr is redirected to /dev/null on
129# purpose, to work around a clang 11 bug that crashes if stderr is
130# redirected to stdin.
131#
Willy Tarreaud3a7f402017-09-13 16:54:28 +0200132# Function used to detect support of a given option by the compiler.
133# Usage: CFLAGS += $(call cc-opt,option). Eg: $(call cc-opt,-fwrapv)
134# Note: ensure the referencing variable is assigned using ":=" and not "=" to
135# call it only once.
Christopher Faulet16150642021-04-14 14:02:56 +0200136cc-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 +0200137
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200138# same but emits $2 if $1 is not supported
Christopher Faulet16150642021-04-14 14:02:56 +0200139cc-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 +0200140
Willy Tarreaub7801662017-09-14 19:05:45 +0200141# Disable a warning when supported by the compiler. Don't put spaces around the
142# warning! And don't use cc-opt which doesn't always report an error until
143# another one is also returned.
144# Usage: CFLAGS += $(call cc-nowarn,warning). Eg: $(call cc-opt,format-truncation)
Christopher Faulet16150642021-04-14 14:02:56 +0200145cc-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 +0200146
Christian Wiesea184aa22008-03-12 15:25:35 +0200147#### Installation options.
148DESTDIR =
149PREFIX = /usr/local
150SBINDIR = $(PREFIX)/sbin
Jeremy Hinegardneref3b4032008-11-15 17:29:03 -0700151MANDIR = $(PREFIX)/share/man
Christian Wiesebf34eb42008-03-12 17:24:49 +0200152DOCDIR = $(PREFIX)/doc/haproxy
Willy Tarreau4f60f162007-04-08 16:39:58 +0200153
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100154#### TARGET system
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500155# Use TARGET=<target_name> to optimize for a specific target OS among the
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100156# following list (use the default "generic" if uncertain) :
Brad Smith382001b2020-10-08 01:15:06 -0400157# linux-glibc, linux-glibc-legacy, linux-musl, solaris, freebsd, dragonfly,
158# openbsd, netbsd, cygwin, haiku, aix51, aix52, aix72-gcc, osx, generic,
159# custom
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100160TARGET =
Willy Tarreau4f60f162007-04-08 16:39:58 +0200161
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100162#### TARGET CPU
163# Use CPU=<cpu_name> to optimize for a particular CPU, among the following
164# list :
Willy Tarreau40a871f2021-05-12 09:47:30 +0200165# generic, native, i586, i686, ultrasparc, power8, power9, custom,
166# a53, a72, armv81, armv8-auto
willy tarreaueedaa9f2005-12-17 14:08:03 +0100167CPU = generic
willy tarreau036e1ce2005-12-17 13:46:33 +0100168
Willy Tarreauef7341d2009-04-11 19:45:50 +0200169#### Architecture, used when not building for native architecture
170# Use ARCH=<arch_name> to force build for a specific architecture. Known
171# architectures will lead to "-m32" or "-m64" being added to CFLAGS and
172# LDFLAGS. This can be required to build 32-bit binaries on 64-bit targets.
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100173# Currently, only 32, 64, x86_64, i386, i486, i586 and i686 are understood.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200174ARCH =
175
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100176#### Toolchain options.
Brad Smith94636432020-09-13 02:53:06 -0400177CC = cc
Christian Wiesef6308302008-03-17 18:23:12 +0100178LD = $(CC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100179
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100180#### Debug flags (typically "-g").
181# Those flags only feed CFLAGS so it is not mandatory to use this form.
182DEBUG_CFLAGS = -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100183
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200184#### Add -Werror when set to non-empty
185ERR =
186
Willy Tarreaudb863332018-11-23 08:29:15 +0100187#### May be used to force running a specific set of reg-tests
188REG_TEST_FILES =
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +0100189REG_TEST_SCRIPT=./scripts/run-regtests.sh
Willy Tarreaudb863332018-11-23 08:29:15 +0100190
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100191#### Compiler-specific flags that may be used to disable some negative over-
Willy Tarreaud1c847a2020-02-25 10:10:47 +0100192# optimization or to silence some warnings.
Olivier Houchard73bdb322017-04-19 11:34:10 +0200193# We rely on signed integer wraparound on overflow, however clang think it
194# can do whatever it wants since it's an undefined behavior, so use -fwrapv
195# to be sure we get the intended behavior.
Willy Tarreau4b61e692020-03-10 09:37:08 +0100196SPEC_CFLAGS := -Wall -Wextra -Wdeclaration-after-statement
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200197SPEC_CFLAGS += $(call cc-opt-alt,-fwrapv,$(call cc-opt,-fno-strict-overflow))
Willy Tarreaub7801662017-09-14 19:05:45 +0200198SPEC_CFLAGS += $(call cc-nowarn,address-of-packed-member)
Willy Tarreaueff9a9e2017-10-27 11:06:11 +0200199SPEC_CFLAGS += $(call cc-nowarn,unused-label)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200200SPEC_CFLAGS += $(call cc-nowarn,sign-compare)
201SPEC_CFLAGS += $(call cc-nowarn,unused-parameter)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200202SPEC_CFLAGS += $(call cc-nowarn,clobbered)
203SPEC_CFLAGS += $(call cc-nowarn,missing-field-initializers)
Olivier Houchard73bce432018-11-27 14:47:58 +0100204SPEC_CFLAGS += $(call cc-nowarn,cast-function-type)
Willy Tarreauc77c2d42019-09-24 09:43:34 +0200205SPEC_CFLAGS += $(call cc-nowarn,string-plus-int)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200206SPEC_CFLAGS += $(call cc-opt,-Wtype-limits)
207SPEC_CFLAGS += $(call cc-opt,-Wshift-negative-value)
208SPEC_CFLAGS += $(call cc-opt,-Wshift-overflow=2)
209SPEC_CFLAGS += $(call cc-opt,-Wduplicated-cond)
210SPEC_CFLAGS += $(call cc-opt,-Wnull-dereference)
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100211
Willy Tarreau4b61e692020-03-10 09:37:08 +0100212ifneq ($(ERR),)
213SPEC_CFLAGS += -Werror
214endif
215
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100216#### Memory usage tuning
217# If small memory footprint is required, you can reduce the buffer size. There
218# are 2 buffers per concurrent session, so 16 kB buffers will eat 32 MB memory
219# with 1000 concurrent sessions. Putting it slightly lower than a page size
220# will prevent the additional parameters to go beyond a page. 8030 bytes is
221# exactly 5.5 TCP segments of 1460 bytes and is generally good. Useful tuning
222# macros include :
223# SYSTEM_MAXCONN, BUFSIZE, MAXREWRITE, REQURI_LEN, CAPTURE_LEN.
224# Example: SMALL_OPTS = -DBUFSIZE=8030 -DMAXREWRITE=1030 -DSYSTEM_MAXCONN=1024
225SMALL_OPTS =
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100226
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100227#### Debug settings
228# You can enable debugging on specific code parts by setting DEBUG=-DDEBUG_xxx.
Willy Tarreau4c442b02020-07-04 12:43:46 +0200229# Use quotes and spaces if multiple options are needed (the DEBUG variables is
230# passed as-is to CFLAGS). Please check sources for their exact meaning or do
231# not use them at all. Some even more obscure ones might also be available
232# without appearing here. Currently defined DEBUG macros include DEBUG_FULL,
233# DEBUG_MEM_STATS, DEBUG_DONT_SHARE_POOLS, DEBUG_NO_LOCKLESS_POOLS, DEBUG_FD,
Willy Tarreau2d6f6282021-04-15 16:24:00 +0200234# DEBUG_NO_POOLS, DEBUG_FAIL_ALLOC, DEBUG_STRICT_NOCRASH, DEBUG_HPACK,
Willy Tarreaub23f0422021-02-16 18:44:00 +0100235# DEBUG_AUTH, DEBUG_SPOE, DEBUG_UAF, DEBUG_THREAD, DEBUG_STRICT, DEBUG_DEV,
236# DEBUG_TASK.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100237DEBUG =
willy tarreau1c2ad212005-12-18 01:11:29 +0100238
Willy Tarreau7de211c2012-05-25 23:53:16 +0200239#### Trace options
240# Use TRACE=1 to trace function calls to file "trace.out" or to stderr if not
241# possible.
242TRACE =
243
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100244#### Additional include and library dirs
245# Redefine this if you want to add some special PATH to include/libs
246ADDINC =
247ADDLIB =
willy tarreau64a3cc32005-12-18 01:13:11 +0100248
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100249#### Specific macro definitions
250# Use DEFINE=-Dxxx to set any tunable macro. Anything declared here will appear
251# in the build options reported by "haproxy -vv". Use SILENT_DEFINE if you do
252# not want to pollute the report with complex defines.
Emeric Brun76d88952012-10-05 15:47:31 +0200253# The following settings might be of interest when SSL is enabled :
254# LISTEN_DEFAULT_CIPHERS is a cipher suite string used to set the default SSL
255# ciphers on "bind" lines instead of using OpenSSL's defaults.
256# CONNECT_DEFAULT_CIPHERS is a cipher suite string used to set the default
257# SSL ciphers on "server" lines instead of using OpenSSL's defaults.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100258DEFINE =
259SILENT_DEFINE =
willy tarreau0f7af912005-12-17 12:21:26 +0100260
William Lallemanda6cfa902017-06-01 17:38:58 +0200261#### extra programs to build
Willy Tarreaubc289da2014-05-10 12:16:21 +0200262# Force this to enable building extra programs or to disable them.
263# It's automatically appended depending on the targets.
264EXTRA =
willy tarreau5cbea6f2005-12-17 12:48:26 +0100265
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500266#### CPU dependent optimizations
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100267# Some CFLAGS are set by default depending on the target CPU. Those flags only
268# feed CPU_CFLAGS, which in turn feed CFLAGS, so it is not mandatory to use
269# them. You should not have to change these options. Better use CPU_CFLAGS or
270# even CFLAGS instead.
271CPU_CFLAGS.generic = -O2
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100272CPU_CFLAGS.native = -O2 -march=native
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100273CPU_CFLAGS.i586 = -O2 -march=i586
274CPU_CFLAGS.i686 = -O2 -march=i686
275CPU_CFLAGS.ultrasparc = -O6 -mcpu=v9 -mtune=ultrasparc
Christian Lachnerc1322302020-02-10 10:29:13 +0100276CPU_CFLAGS.power8 = -O2 -mcpu=power8 -mtune=power8
277CPU_CFLAGS.power9 = -O2 -mcpu=power9 -mtune=power9
Willy Tarreau40a871f2021-05-12 09:47:30 +0200278CPU_CFLAGS.a53 = -O2 -mcpu=cortex-a53
279CPU_CFLAGS.a72 = -O2 -mcpu=cortex-a72
280CPU_CFLAGS.armv81 = -O2 -march=armv8.1-a
281CPU_CFLAGS.armv8-auto = -O2 -march=armv8-a+crc -moutline-atomics
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100282CPU_CFLAGS = $(CPU_CFLAGS.$(CPU))
willy tarreau9da061b2005-12-17 12:29:56 +0100283
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500284#### ARCH dependent flags, may be overridden by CPU flags
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100285ARCH_FLAGS.32 = -m32
286ARCH_FLAGS.64 = -m64
Willy Tarreauef7341d2009-04-11 19:45:50 +0200287ARCH_FLAGS.i386 = -m32 -march=i386
288ARCH_FLAGS.i486 = -m32 -march=i486
289ARCH_FLAGS.i586 = -m32 -march=i586
290ARCH_FLAGS.i686 = -m32 -march=i686
291ARCH_FLAGS.x86_64 = -m64 -march=x86-64
292ARCH_FLAGS = $(ARCH_FLAGS.$(ARCH))
293
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100294#### Common CFLAGS
295# These CFLAGS contain general optimization options, CPU-specific optimizations
296# and debug flags. They may be overridden by some distributions which prefer to
297# set all of them at once instead of playing with the CPU and DEBUG variables.
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100298CFLAGS = $(ARCH_FLAGS) $(CPU_CFLAGS) $(DEBUG_CFLAGS) $(SPEC_CFLAGS)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100299
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100300#### Common LDFLAGS
301# These LDFLAGS are used as the first "ld" options, regardless of any library
302# path or any other option. They may be changed to add any linker-specific
303# option at the beginning of the ld command line.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200304LDFLAGS = $(ARCH_FLAGS) -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100305
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100306#### list of all "USE_*" options. These ones must be updated if new options are
307# added, so that the relevant options are properly added to the CFLAGS and to
308# the reported build options.
Willy Tarreau06c63ae2020-03-10 07:20:10 +0100309use_opts = USE_EPOLL USE_KQUEUE USE_NETFILTER \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100310 USE_PCRE USE_PCRE_JIT USE_PCRE2 USE_PCRE2_JIT USE_POLL \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100311 USE_PRIVATE_CACHE USE_THREAD USE_PTHREAD_PSHARED USE_BACKTRACE \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100312 USE_STATIC_PCRE USE_STATIC_PCRE2 USE_TPROXY USE_LINUX_TPROXY \
Willy Tarreauc3e926b2020-03-10 06:48:17 +0100313 USE_LINUX_SPLICE USE_LIBCRYPT USE_CRYPT_H \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100314 USE_GETADDRINFO USE_OPENSSL USE_LUA USE_FUTEX USE_ACCEPT4 \
Brad Smith5018aac2020-09-30 01:04:48 -0400315 USE_CLOSEFROM USE_ZLIB USE_SLZ USE_CPU_AFFINITY USE_TFO USE_NS \
Willy Tarreau14261982019-04-23 10:57:09 +0200316 USE_DL USE_RT USE_DEVICEATLAS USE_51DEGREES USE_WURFL USE_SYSTEMD \
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100317 USE_OBSOLETE_LINKER USE_PRCTL USE_THREAD_DUMP USE_EVPORTS USE_OT \
Willy Tarreauf6818d62021-05-05 18:17:39 +0200318 USE_QUIC USE_PROMEX USE_MEMORY_PROFILING
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100319
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100320#### Target system options
321# Depending on the target platform, some options are set, as well as some
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100322# CFLAGS and LDFLAGS. All variables pre-set here will not appear in the build
323# options string. They may be set to any value, but are historically set to
324# "implicit" which eases debugging. You should not have to change anything
325# there unless you're adding support for a new platform.
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100326default_opts = $(foreach name,$(1),$(eval $(name)=implicit))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100327
328# poll() is always supported, unless explicitly disabled by passing USE_POLL=""
329# on the make command line.
Willy Tarreau32e65ef2013-04-02 08:14:29 +0200330USE_POLL = default
331
Willy Tarreau12840be2021-04-22 14:14:22 +0200332# SLZ is always supported unless explicitly disabled by passing USE_SLZ=""
333# or disabled by enabling ZLIB using USE_ZLIB=1
334ifeq ($(USE_ZLIB),)
335USE_SLZ = default
336endif
337
Christopher Fauleta1ae7e82017-10-25 17:55:27 +0200338# Always enable threads support by default and let the Makefile detect if
339# HAProxy can be compiled with threads or not.
340
Willy Tarreau39f19922019-03-27 11:44:19 +0100341# generic system target has nothing specific
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100342ifeq ($(TARGET),generic)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100343 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY)
Willy Tarreau39f19922019-03-27 11:44:19 +0100344endif
345
346# Haiku
Jerome Duval38932c32015-10-19 23:01:16 +0000347ifeq ($(TARGET),haiku)
Jerome Duval38932c32015-10-19 23:01:16 +0000348 TARGET_LDFLAGS = -lnetwork
David Carlierb2f06cc2021-06-19 14:42:43 +0000349 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Willy Tarreau39f19922019-03-27 11:44:19 +0100350endif
351
Willy Tarreau61cf0dc2019-06-14 16:32:09 +0200352# For linux >= 2.6.28 and glibc
353ifeq ($(TARGET),linux-glibc)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100354 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100355 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
356 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
Willy Tarreau364d6f52019-06-14 18:33:56 +0200357 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100358 USE_GETADDRINFO USE_BACKTRACE)
Willy Tarreau48e86032020-03-18 08:20:45 +0100359ifneq ($(shell echo __arm__/__aarch64__ | $(CC) -E -xc - | grep '^[^\#]'),__arm__/__aarch64__)
David Carlierd93e6ec2020-03-15 10:30:51 +0000360 TARGET_LDFLAGS=-latomic
361endif
Willy Tarreau39f19922019-03-27 11:44:19 +0100362endif
363
Lukas Tribuscc1eb162019-09-01 16:48:36 +0200364# For linux >= 2.6.28, glibc without new features
365ifeq ($(TARGET),linux-glibc-legacy)
366 set_target_defaults = $(call default_opts, \
367 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
368 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
369 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_GETADDRINFO)
370endif
371
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200372# For linux >= 2.6.28 and musl
373ifeq ($(TARGET),linux-musl)
374 set_target_defaults = $(call default_opts, \
375 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
376 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
377 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
378 USE_GETADDRINFO)
379ifneq ($(shell echo __arm__/__aarch64__ | $(CC) -E -xc - | grep '^[^\#]'),__arm__/__aarch64__)
380 TARGET_LDFLAGS=-latomic
381endif
382endif
383
Brad Smith7c503bb2020-09-30 15:46:16 -0400384# Solaris 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100385ifeq ($(TARGET),solaris)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100386 set_target_defaults = $(call default_opts, \
Emmanuel Hocdet7093c192019-05-21 09:12:03 +0000387 USE_POLL USE_TPROXY USE_LIBCRYPT USE_CRYPT_H USE_GETADDRINFO USE_THREAD \
Brad Smith7c503bb2020-09-30 15:46:16 -0400388 USE_RT USE_OBSOLETE_LINKER USE_EVPORTS USE_CLOSEFROM)
Emmanuel Hocdet3c0edfa2019-05-17 15:32:21 +0000389 TARGET_CFLAGS = -DFD_SETSIZE=65536 -D_REENTRANT -D_XOPEN_SOURCE=500 -D__EXTENSIONS__
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100390 TARGET_LDFLAGS = -lnsl -lsocket
Willy Tarreau39f19922019-03-27 11:44:19 +0100391endif
392
Brad Smith9d85eb02020-09-15 03:10:04 -0400393# FreeBSD 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100394ifeq ($(TARGET),freebsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100395 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100396 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
Brad Smith9d85eb02020-09-15 03:10:04 -0400397 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100398endif
399
Brad Smith382001b2020-10-08 01:15:06 -0400400# DragonFlyBSD 4.3 and above
401ifeq ($(TARGET),dragonfly)
402 set_target_defaults = $(call default_opts, \
403 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
404 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO)
405endif
406
Willy Tarreau39f19922019-03-27 11:44:19 +0100407# Mac OS/X
Willy Tarreau8624cab2013-04-02 08:17:43 +0200408ifeq ($(TARGET),osx)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100409 set_target_defaults = $(call default_opts, \
Brad Smithad5afba2020-10-09 19:26:23 -0400410 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
411 USE_GETADDRINFO)
Willy Tarreaub684e7a2018-03-05 15:37:04 +0100412 EXPORT_SYMBOL = -export_dynamic
Willy Tarreau39f19922019-03-27 11:44:19 +0100413endif
414
Brad Smith90c9d782020-09-26 23:05:25 -0400415# OpenBSD 6.3 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100416ifeq ($(TARGET),openbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100417 set_target_defaults = $(call default_opts, \
Matthieu Guegan496374e2020-11-20 10:50:39 +0100418 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_KQUEUE USE_ACCEPT4 \
419 USE_CLOSEFROM USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100420endif
421
Brad Smith0fdfe412020-10-08 16:24:52 -0400422# NetBSD 8 and above
David Carlierb5714da2015-07-02 06:58:22 +0000423ifeq ($(TARGET),netbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100424 set_target_defaults = $(call default_opts, \
Brad Smith0fdfe412020-10-08 16:24:52 -0400425 USE_POLL USE_TPROXY USE_THREAD USE_KQUEUE USE_ACCEPT4 USE_CLOSEFROM \
426 USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100427endif
428
429# AIX 5.1 only
Willy Tarreau50abe302014-04-02 20:44:43 +0200430ifeq ($(TARGET),aix51)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100431 set_target_defaults = $(call default_opts, \
Willy Tarreau13d9b022019-03-29 18:56:54 +0100432 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER USE_PRIVATE_CACHE)
Willy Tarreau0aed6ac2019-03-29 18:56:00 +0100433 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 +0200434 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100435endif
436
Christian Lachnerc1322302020-02-10 10:29:13 +0100437# AIX 5.2
Willy Tarreau7dec9652012-06-06 16:15:03 +0200438ifeq ($(TARGET),aix52)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100439 set_target_defaults = $(call default_opts, \
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100440 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER)
Willy Tarreau7dec9652012-06-06 16:15:03 +0200441 TARGET_CFLAGS = -D_MSGQSUPPORT
442 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100443endif
444
Christian Lachnerc1322302020-02-10 10:29:13 +0100445# AIX 7.2 and above
446ifeq ($(TARGET),aix72-gcc)
447 set_target_defaults = $(call default_opts, \
448 USE_POLL USE_THREAD USE_LIBCRYPT USE_OBSOLETE_LINKER USE_GETADDRINFO)
449 TARGET_CFLAGS = -D_H_XMEM -D_H_VAR
450 TARGET_LDFLAGS = -latomic
451endif
452
Willy Tarreau39f19922019-03-27 11:44:19 +0100453# Cygwin
Yitzhak Sapir32087312009-06-14 18:27:54 +0200454ifeq ($(TARGET),cygwin)
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100455 set_target_defaults = $(call default_opts, \
456 USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -0700457 # Cygwin adds IPv6 support only in version 1.7 (in beta right now).
Yitzhak Sapir32087312009-06-14 18:27:54 +0200458 TARGET_CFLAGS = $(if $(filter 1.5.%, $(shell uname -r)), -DUSE_IPV6 -DAF_INET6=23 -DINET6_ADDRSTRLEN=46, )
Willy Tarreau39f19922019-03-27 11:44:19 +0100459endif
willy tarreau4373b962005-12-18 01:32:31 +0100460
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100461# set the default settings according to the target above
462$(set_target_defaults)
463
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100464#### Determine version, sub-version and release date.
465# If GIT is found, and IGNOREGIT is not set, VERSION, SUBVERS and VERDATE are
466# extracted from the last commit. Otherwise, use the contents of the files
467# holding the same names in the current directory.
willy tarreau0174f312005-12-18 01:02:42 +0100468
Willy Tarreau6620dbb2007-01-02 00:44:53 +0100469ifeq ($(IGNOREGIT),)
Willy Tarreau3c55efb2019-06-22 08:24:16 +0200470VERSION := $(shell [ -d .git/. ] && (git describe --tags --match 'v*' --abbrev=0 | cut -c 2-) 2>/dev/null)
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100471ifneq ($(VERSION),)
472# OK git is there and works.
Willy Tarreau30a6f642019-06-22 07:51:02 +0200473SUBVERS := $(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 +0100474VERDATE := $(shell git log -1 --pretty=format:%ci | cut -f1 -d' ' | tr '-' '/')
Willy Tarreauec692562007-09-09 23:31:11 +0200475endif
476endif
477
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100478# Last commit version not found, take it from the files.
Willy Tarreauec692562007-09-09 23:31:11 +0200479ifeq ($(VERSION),)
480VERSION := $(shell cat VERSION 2>/dev/null || touch VERSION)
481endif
482ifeq ($(SUBVERS),)
Willy Tarreau6173bbe2013-12-16 01:34:39 +0100483SUBVERS := $(shell (grep -v '\$$Format' SUBVERS 2>/dev/null || touch SUBVERS) | head -n 1)
Willy Tarreauec692562007-09-09 23:31:11 +0200484endif
485ifeq ($(VERDATE),)
Willy Tarreauf1ed3272014-01-26 00:39:22 +0100486VERDATE := $(shell (grep -v '^\$$Format' VERDATE 2>/dev/null || touch VERDATE) | head -n 1 | cut -f1 -d' ' | tr '-' '/')
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100487endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100488
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200489# this one is always empty by default and appended verbatim
490EXTRAVERSION =
491
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100492#### Build options
493# Do not change these ones, enable USE_* variables instead.
494OPTIONS_CFLAGS =
495OPTIONS_LDFLAGS =
496OPTIONS_OBJS =
Willy Tarreau77074d52006-11-12 23:57:19 +0100497
Willy Tarreauada5d092019-01-10 10:01:03 +0100498#### Extra objects to be built and integrated (used only for development)
499EXTRA_OBJS =
500
Willy Tarreau09fe5662019-03-27 10:36:35 +0100501# Return USE_xxx=$(USE_xxx) if the variable was set from the environment or the
502# command line.
503# Usage:
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100504# BUILD_OPTIONS += $(call ignore_implicit,USE_xxx)
Willy Tarreau09fe5662019-03-27 10:36:35 +0100505ignore_implicit = $(if $(subst environment,,$(origin $(1))), \
506 $(if $(subst command line,,$(origin $(1))),, \
507 $(1)=$($(1))), \
508 $(1)=$($(1))) \
Willy Tarreau77074d52006-11-12 23:57:19 +0100509
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100510# This variable collects all USE_* values except those set to "implicit". This
511# is used to report a list of all flags which were used to build this version.
512# Do not assign anything to it.
Willy Tarreau7728ed32019-03-27 13:20:08 +0100513BUILD_OPTIONS := $(foreach opt,$(use_opts),$(call ignore_implicit,$(opt)))
514BUILD_FEATURES := $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),+$(opt),-$(opt)))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100515
Willy Tarreau824cd002019-03-27 14:44:14 +0100516# All USE_* options have their equivalent macro defined in the code (some might
517# possibly be unused though)
518OPTIONS_CFLAGS += $(foreach opt,$(use_opts),$(if $($(opt)),-D$(opt),))
519
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100520ifneq ($(USE_LIBCRYPT),)
Matthieu Guegan496374e2020-11-20 10:50:39 +0100521ifneq ($(TARGET),openbsd)
David Carlier6c00eba2019-09-01 14:59:10 +0100522ifneq ($(TARGET),osx)
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100523OPTIONS_LDFLAGS += -lcrypt
524endif
David Carlier6c00eba2019-09-01 14:59:10 +0100525endif
Matthieu Guegan496374e2020-11-20 10:50:39 +0100526endif
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100527
William Lallemand82fe75c2012-10-23 10:25:10 +0200528ifneq ($(USE_ZLIB),)
Willy Tarreaue2f49442012-02-10 20:37:26 +0100529# Use ZLIB_INC and ZLIB_LIB to force path to zlib.h and libz.{a,so} if needed.
530ZLIB_INC =
531ZLIB_LIB =
Willy Tarreau824cd002019-03-27 14:44:14 +0100532OPTIONS_CFLAGS += $(if $(ZLIB_INC),-I$(ZLIB_INC))
Willy Tarreaue2f49442012-02-10 20:37:26 +0100533OPTIONS_LDFLAGS += $(if $(ZLIB_LIB),-L$(ZLIB_LIB)) -lz
William Lallemand82fe75c2012-10-23 10:25:10 +0200534endif
535
Willy Tarreau12840be2021-04-22 14:14:22 +0200536ifneq ($(USE_SLZ),)
537OPTIONS_OBJS += src/slz.o
538endif
539
Willy Tarreau77074d52006-11-12 23:57:19 +0100540ifneq ($(USE_POLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100541OPTIONS_OBJS += src/ev_poll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100542endif
543
544ifneq ($(USE_EPOLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100545OPTIONS_OBJS += src/ev_epoll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100546endif
547
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100548ifneq ($(USE_KQUEUE),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100549OPTIONS_OBJS += src/ev_kqueue.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100550endif
551
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000552ifneq ($(USE_EVPORTS),)
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000553OPTIONS_OBJS += src/ev_evports.o
554endif
555
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100556ifneq ($(USE_DL),)
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100557OPTIONS_LDFLAGS += -ldl
558endif
559
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200560ifneq ($(USE_RT),)
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200561OPTIONS_LDFLAGS += -lrt
562endif
563
Willy Tarreauc0bbdc12020-03-04 08:31:47 +0100564ifneq ($(USE_THREAD),)
565OPTIONS_LDFLAGS += -lpthread
566endif
567
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100568ifneq ($(USE_BACKTRACE),)
569OPTIONS_LDFLAGS += -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic)
570endif
571
Amaury Denoyellef75c6402021-04-14 15:03:51 +0200572ifneq ($(USE_CPU_AFFINITY),)
573OPTIONS_OBJS += src/cpuset.o
574endif
575
Emeric Brun7444f012012-05-18 15:48:30 +0200576ifneq ($(USE_OPENSSL),)
Ilya Shipitsinf21023e2020-08-04 15:36:24 +0500577SSL_INC =
578SSL_LIB =
David CARLIER7385f652015-11-06 15:13:06 +0000579# OpenSSL is packaged in various forms and with various dependencies.
Emeric Brun7444f012012-05-18 15:48:30 +0200580# In general -lssl is enough, but on some platforms, -lcrypto may be needed,
Willy Tarreau8f182d92012-09-10 09:11:22 +0200581# reason why it's added by default. Some even need -lz, then you'll need to
Willy Tarreau9a059452013-09-17 15:26:39 +0200582# pass it in the "ADDLIB" variable if needed. If your SSL libraries are not
583# in the usual path, use SSL_INC=/path/to/inc and SSL_LIB=/path/to/lib.
Willy Tarreau824cd002019-03-27 14:44:14 +0100584OPTIONS_CFLAGS += $(if $(SSL_INC),-I$(SSL_INC))
Willy Tarreaucd360ce2014-10-31 07:36:51 +0100585OPTIONS_LDFLAGS += $(if $(SSL_LIB),-L$(SSL_LIB)) -lssl -lcrypto
Dirkjan Bussink1866d6d2016-08-29 13:26:37 +0200586ifneq ($(USE_DL),)
587OPTIONS_LDFLAGS += -ldl
588endif
William Lallemand6a66a5e2020-05-15 12:01:17 +0200589OPTIONS_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 +0100590endif
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100591ifneq ($(USE_QUIC),)
592OPTIONS_OBJS += src/quic_sock.o src/proto_quic.o src/xprt_quic.o src/quic_tls.o \
593 src/quic_frame.o src/quic_cc.o src/quic_cc_newreno.o
594endif
William Lallemandb620e982017-11-02 16:00:51 +0100595
596# The private cache option affect the way the shctx is built
Willy Tarreau824cd002019-03-27 14:44:14 +0100597ifeq ($(USE_PRIVATE_CACHE),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200598ifneq ($(USE_PTHREAD_PSHARED),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200599OPTIONS_LDFLAGS += -lpthread
Emeric Bruncd1a5262014-05-07 23:11:42 +0200600endif
Emeric Brun3e541d12012-09-03 11:14:36 +0200601endif
Olivier Houchard2292edf2019-02-25 14:26:54 +0100602
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100603ifneq ($(USE_LUA),)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100604check_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 +0800605check_lua_inc = $(shell if [ -d $(2)$(1) ]; then echo $(2)$(1); fi;)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100606
Willy Tarreau824cd002019-03-27 14:44:14 +0100607OPTIONS_CFLAGS += $(if $(LUA_INC),-I$(LUA_INC))
Thierry Fournier13113d62018-02-26 09:25:56 +0100608LUA_LD_FLAGS := -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic) $(if $(LUA_LIB),-L$(LUA_LIB))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100609ifeq ($(LUA_LIB_NAME),)
610# Try to automatically detect the Lua library
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100611LUA_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 +0100612ifeq ($(LUA_LIB_NAME),)
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100613$(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 +0100614endif
Nan Liub286fff2017-06-09 15:57:45 +0800615LUA_INC := $(firstword $(foreach lib,lua5.3 lua53 lua,$(call check_lua_inc,$(lib),"/usr/include/")))
616ifneq ($(LUA_INC),)
617OPTIONS_CFLAGS += -I$(LUA_INC)
618endif
Tim Duesterhus541fe1e2020-01-12 13:55:41 +0100619ifneq ($(HLUA_PREPEND_PATH),)
620OPTIONS_CFLAGS += -DHLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
621BUILD_OPTIONS += HLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
622endif
623ifneq ($(HLUA_PREPEND_CPATH),)
624OPTIONS_CFLAGS += -DHLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
625BUILD_OPTIONS += HLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
626endif
Cyril Bontéc21adb52015-03-03 23:13:03 +0100627endif
628
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100629OPTIONS_LDFLAGS += $(LUA_LD_FLAGS) -l$(LUA_LIB_NAME) -lm
Vincent Bernate192cbb2015-07-16 20:52:51 +0200630ifneq ($(USE_DL),)
631OPTIONS_LDFLAGS += -ldl
632endif
Thierry Fournierfb0b5462016-01-21 09:28:58 +0100633OPTIONS_OBJS += src/hlua.o src/hlua_fcn.o
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100634endif
635
Willy Tarreau92dc7862021-04-02 15:31:10 +0200636ifneq ($(USE_PROMEX),)
Willy Tarreau3dfadc72021-04-02 15:35:19 +0200637OPTIONS_OBJS += addons/promex/service-prometheus.o
Willy Tarreau92dc7862021-04-02 15:31:10 +0200638endif
639
David Carliera03fb142015-06-01 14:00:07 +0200640ifneq ($(USE_DEVICEATLAS),)
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200641# Use DEVICEATLAS_SRC and possibly DEVICEATLAS_INC and DEVICEATLAS_LIB to force path
Dragan Dosen93b38d92015-06-29 16:43:25 +0200642# to DeviceAtlas headers and libraries if needed.
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200643DEVICEATLAS_SRC =
644DEVICEATLAS_INC = $(DEVICEATLAS_SRC)
645DEVICEATLAS_LIB = $(DEVICEATLAS_SRC)
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100646ifeq ($(DEVICEATLAS_SRC),)
647OPTIONS_LDFLAGS += -lda
648else
David Carlier019dbd72021-02-16 11:37:45 +0000649ifeq ($(USE_PCRE),)
650ifeq ($(USE_PCRE2),)
651$(error the DeviceAtlas module needs the PCRE or the PCRE2 library in order to compile)
652endif
653endif
654ifneq ($(USE_PCRE2),)
655OPTIONS_CFLAGS += -DDA_REGEX_HDR=\"dac_pcre2.c\" -DDA_REGEX_TAG=2
656endif
David Carliera03fb142015-06-01 14:00:07 +0200657OPTIONS_OBJS += $(DEVICEATLAS_LIB)/json.o
658OPTIONS_OBJS += $(DEVICEATLAS_LIB)/dac.o
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100659endif
Willy Tarreauf8d9ec52021-04-02 16:19:39 +0200660OPTIONS_OBJS += addons/deviceatlas/da.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100661OPTIONS_CFLAGS += $(if $(DEVICEATLAS_INC),-I$(DEVICEATLAS_INC))
David Carliera03fb142015-06-01 14:00:07 +0200662endif
663
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100664ifneq ($(USE_51DEGREES),)
Willy Tarreauc7203c72015-06-01 11:12:35 +0200665# Use 51DEGREES_SRC and possibly 51DEGREES_INC and 51DEGREES_LIB to force path
666# to 51degrees headers and libraries if needed.
66751DEGREES_SRC =
66851DEGREES_INC = $(51DEGREES_SRC)
66951DEGREES_LIB = $(51DEGREES_SRC)
James Rosewell3670eb12015-09-18 17:24:29 +0100670OPTIONS_OBJS += $(51DEGREES_LIB)/../cityhash/city.o
Dragan Dosen93b38d92015-06-29 16:43:25 +0200671OPTIONS_OBJS += $(51DEGREES_LIB)/51Degrees.o
Willy Tarreau977209d2021-04-02 16:12:32 +0200672OPTIONS_OBJS += addons/51degrees/51d.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100673OPTIONS_CFLAGS += $(if $(51DEGREES_INC),-I$(51DEGREES_INC))
Ben51Degrees4ddf59d2019-02-05 13:24:00 +0000674ifeq ($(USE_THREAD),)
675OPTIONS_CFLAGS += -DFIFTYONEDEGREES_NO_THREADING
676else
677OPTIONS_OBJS += $(51DEGREES_LIB)/../threading.o
678endif
679
James Rosewell3670eb12015-09-18 17:24:29 +0100680OPTIONS_LDFLAGS += $(if $(51DEGREES_LIB),-L$(51DEGREES_LIB)) -lm
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100681endif
682
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200683ifneq ($(USE_WURFL),)
684# Use WURFL_SRC and possibly WURFL_INC and WURFL_LIB to force path
685# to WURFL headers and libraries if needed.
686WURFL_SRC =
687WURFL_INC = $(WURFL_SRC)
688WURFL_LIB = $(WURFL_SRC)
Willy Tarreau57610c62021-04-02 16:39:44 +0200689OPTIONS_OBJS += addons/wurfl/wurfl.o
Willy Tarreau14261982019-04-23 10:57:09 +0200690OPTIONS_CFLAGS += $(if $(WURFL_INC),-I$(WURFL_INC))
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200691ifneq ($(WURFL_DEBUG),)
692OPTIONS_CFLAGS += -DWURFL_DEBUG
693endif
694ifneq ($(WURFL_HEADER_WITH_DETAILS),)
695OPTIONS_CFLAGS += -DWURFL_HEADER_WITH_DETAILS
696endif
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200697OPTIONS_LDFLAGS += $(if $(WURFL_LIB),-L$(WURFL_LIB)) -lwurfl
698endif
699
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100700ifneq ($(USE_SYSTEMD),)
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100701OPTIONS_LDFLAGS += -lsystemd
702endif
703
Hiroaki Nakamura70351322013-01-13 15:00:42 +0900704ifneq ($(USE_PCRE)$(USE_STATIC_PCRE)$(USE_PCRE_JIT),)
David Carlierf2592b22016-11-21 21:25:58 +0000705ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
706$(error cannot compile both PCRE and PCRE2 support)
707endif
Willy Tarreau39793092013-02-13 12:39:06 +0100708# PCREDIR is used to automatically construct the PCRE_INC and PCRE_LIB paths,
709# by appending /include and /lib respectively. If your system does not use the
710# same sub-directories, simply force these variables instead of PCREDIR. It is
711# automatically detected but can be forced if required (for cross-compiling).
712# Forcing PCREDIR to an empty string will let the compiler use the default
713# locations.
714
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200715PCRE_CONFIG := pcre-config
716PCREDIR := $(shell $(PCRE_CONFIG) --prefix 2>/dev/null || echo /usr/local)
Willy Tarreau39793092013-02-13 12:39:06 +0100717ifneq ($(PCREDIR),)
718PCRE_INC := $(PCREDIR)/include
719PCRE_LIB := $(PCREDIR)/lib
Willy Tarreau79b34bf2006-12-22 15:28:43 +0100720endif
Willy Tarreau39793092013-02-13 12:39:06 +0100721
Christian Wiesec8203002008-11-20 14:47:04 +0100722ifeq ($(USE_STATIC_PCRE),)
Willy Tarreau39793092013-02-13 12:39:06 +0100723# dynamic PCRE
724OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
725OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -lpcreposix -lpcre
Willy Tarreau39793092013-02-13 12:39:06 +0100726else
727# static PCRE
728OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
729OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -Wl,-Bstatic -lpcreposix -lpcre -Wl,-Bdynamic
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100730endif
Willy Tarreau39793092013-02-13 12:39:06 +0100731endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100732
David Carlierf2592b22016-11-21 21:25:58 +0000733ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200734PCRE2_CONFIG := pcre2-config
735PCRE2DIR := $(shell $(PCRE2_CONFIG) --prefix 2>/dev/null || echo /usr/local)
David Carlierf2592b22016-11-21 21:25:58 +0000736ifneq ($(PCRE2DIR),)
737PCRE2_INC := $(PCRE2DIR)/include
738PCRE2_LIB := $(PCRE2DIR)/lib
739
740ifeq ($(PCRE2_WIDTH),)
741PCRE2_WIDTH = 8
742endif
743
744ifneq ($(PCRE2_WIDTH),8)
745ifneq ($(PCRE2_WIDTH),16)
746ifneq ($(PCRE2_WIDTH),32)
747$(error PCRE2_WIDTH needs to be set to either 8,16 or 32)
748endif
749endif
750endif
751
752
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200753PCRE2_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 +0000754
755ifeq ($(PCRE2_LDFLAGS),)
756$(error libpcre2-$(PCRE2_WIDTH) not found)
757else
758ifeq ($(PCRE2_WIDTH),8)
759PCRE2_LDFLAGS += -lpcre2-posix
760endif
761endif
762
763OPTIONS_CFLAGS += -DUSE_PCRE2 -DPCRE2_CODE_UNIT_WIDTH=$(PCRE2_WIDTH)
764OPTIONS_CFLAGS += $(if $(PCRE2_INC), -I$(PCRE2_INC))
765
766ifneq ($(USE_STATIC_PCRE2),)
767OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -Wl,-Bstatic -L$(PCRE2_LIB) $(PCRE2_LDFLAGS) -Wl,-Bdynamic
David Carlierf2592b22016-11-21 21:25:58 +0000768else
769OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -L$(PCRE2_LIB) $(PCRE2_LDFLAGS)
David Carlierf2592b22016-11-21 21:25:58 +0000770endif
771
David Carlierf2592b22016-11-21 21:25:58 +0000772endif
773endif
774
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100775#### Global compile options
776VERBOSE_CFLAGS = $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE)
Willy Tarreaufc80e302020-05-27 11:05:33 +0200777COPTS = -Iinclude
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200778
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100779COPTS += $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE) $(SILENT_DEFINE)
780COPTS += $(DEBUG) $(OPTIONS_CFLAGS) $(ADDINC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100781
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200782ifneq ($(VERSION)$(SUBVERS)$(EXTRAVERSION),)
783COPTS += -DCONFIG_HAPROXY_VERSION=\"$(VERSION)$(SUBVERS)$(EXTRAVERSION)\"
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100784endif
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100785
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100786ifneq ($(VERDATE),)
787COPTS += -DCONFIG_HAPROXY_DATE=\"$(VERDATE)\"
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100788endif
789
Willy Tarreau7de211c2012-05-25 23:53:16 +0200790ifneq ($(TRACE),)
791# if tracing is enabled, we want it to be as fast as possible
792TRACE_COPTS := $(filter-out -O0 -O1 -O2 -pg -finstrument-functions,$(COPTS)) -O3 -fomit-frame-pointer
793COPTS += -finstrument-functions
794endif
795
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100796ifneq ($(USE_NS),)
Willy Tarreau7520e4f2018-11-11 14:38:09 +0100797OPTIONS_OBJS += src/namespace.o
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100798endif
799
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100800ifneq ($(USE_OT),)
Willy Tarreaua63d1a02021-04-02 17:16:46 +0200801include addons/ot/Makefile
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100802endif
803
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100804#### Global link options
805# These options are added at the end of the "ld" command line. Use LDFLAGS to
806# add options at the beginning of the "ld" command line if needed.
807LDOPTS = $(TARGET_LDFLAGS) $(OPTIONS_LDFLAGS) $(ADDLIB)
willy tarreau0f7af912005-12-17 12:21:26 +0100808
Willy Tarreau16119652018-11-19 08:15:54 +0100809ifeq ($V,1)
810cmd_CC = $(CC)
811cmd_LD = $(LD)
812cmd_AR = $(AR)
813else
814cmd_CC = $(Q)echo " CC $@";$(CC)
815cmd_LD = $(Q)echo " LD $@";$(LD)
816cmd_AR = $(Q)echo " AR $@";$(AR)
817endif
818
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100819ifeq ($(TARGET),)
820all:
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100821 @echo "Building HAProxy without specifying a TARGET is not supported."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100822 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100823 @echo "Usage:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100824 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100825 @echo " $ make help # To print a full explanation."
826 @echo " $ make TARGET=xxx USE_<feature>=1 # To build HAProxy."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100827 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100828 @echo "The most commonly used targets are:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100829 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100830 @echo " linux-glibc - Modern Linux with glibc"
831 @echo " linux-musl - Modern Linux with musl"
832 @echo " freebsd - FreeBSD"
833 @echo " openbsd - OpenBSD"
834 @echo " netbsd - NetBSD"
835 @echo " osx - macOS"
836 @echo " solaris - Solaris"
837 @echo
838 @echo "Choose the target which matches your OS the most in order to"
839 @echo "gain the maximum performance out of it."
840 @echo
841 @echo "Common features you might want to include in your build are:"
842 @echo
843 @echo " USE_OPENSSL=1 - Support for TLS encrypted connections"
844 @echo " USE_ZLIB=1 - Support for HTTP response compression"
845 @echo " USE_PCRE=1 - Support for PCRE regular expressions"
846 @echo " USE_LUA=1 - Support for dynamic processing using Lua"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100847 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100848 @echo "Use 'make help' to print a full explanation of supported targets"
849 @echo "and features."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100850 @echo
851 @exit 1
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200852else
853ifneq ($(filter $(TARGET), linux linux22 linux24 linux24e linux26 linux2628),)
Willy Tarreau99e49e92019-06-14 16:44:49 +0200854all:
855 @echo
856 @echo "Target '$(TARGET)' was removed from HAProxy 2.0 due to being irrelevant and"
857 @echo "often wrong. Please use 'linux-glibc' instead or define your custom target"
858 @echo "by checking available options using 'make help TARGET=<your-target>'."
859 @echo
860 @exit 1
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100861else
Willy Tarreau888bda02021-04-02 13:59:17 +0200862all: haproxy dev/flags/flags $(EXTRA)
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100863endif
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200864endif
willy tarreau0f7af912005-12-17 12:21:26 +0100865
Willy Tarreau2404e372020-11-05 16:42:25 +0100866OBJS =
Willy Tarreau7de211c2012-05-25 23:53:16 +0200867
Willy Tarreauada5d092019-01-10 10:01:03 +0100868ifneq ($(EXTRA_OBJS),)
869OBJS += $(EXTRA_OBJS)
870endif
Marc-Antoine Perennoued9803e2013-02-12 10:53:53 +0100871
Willy Tarreau1d142622021-05-08 23:33:25 +0200872OBJS += src/mux_h2.o src/mux_fcgi.o src/http_ana.o src/mux_h1.o src/stream.o \
873 src/tcpcheck.o src/stats.o src/flt_spoe.o src/server.o src/tools.o \
874 src/sample.o src/log.o src/backend.o src/stick_table.o src/cfgparse.o \
875 src/peers.o src/cli.o src/pattern.o src/resolvers.o src/proxy.o \
876 src/http_htx.o src/check.o src/cache.o src/cfgparse-listen.o \
877 src/haproxy.o src/http_act.o src/stream_interface.o src/http_fetch.o \
878 src/listener.o src/dns.o src/connection.o src/tcp_rules.o src/debug.o \
879 src/sink.o src/payload.o src/mux_pt.o src/filters.o src/fcgi-app.o \
880 src/server_state.o src/vars.o src/map.o src/cfgparse-global.o \
881 src/task.o src/flt_http_comp.o src/session.o src/sock.o \
882 src/flt_trace.o src/acl.o src/trace.o src/http_rules.o src/queue.o \
883 src/mjson.o src/h2.o src/h1.o src/mworker.o src/lb_chash.o src/ring.o \
884 src/activity.o src/tcp_sample.o src/proto_tcp.o src/htx.o src/h1_htx.o \
885 src/extcheck.o src/channel.o src/proto_sockpair.o src/fd.o \
886 src/compression.o src/mqtt.o src/tcp_act.o src/raw_sock.o \
887 src/frontend.o src/http_conv.o src/xprt_handshake.o src/pool.o \
888 src/applet.o src/mailers.o src/lb_fwrr.o src/lb_fwlc.o src/lb_fas.o \
889 src/proto_uxst.o src/http.o src/action.o src/protocol.o src/thread.o \
890 src/sock_unix.o src/proto_udp.o src/lb_map.o src/sock_inet.o src/lru.o \
891 src/cfgparse-tcp.o src/cfgdiag.o src/proto_uxdg.o src/ev_select.o \
892 src/cfgparse-unix.o src/uri_normalizer.o src/ebmbtree.o src/sha1.o \
893 src/time.o src/signal.o src/mworker-prog.o src/hpack-dec.o src/fix.o \
894 src/arg.o src/eb64tree.o src/chunk.o src/shctx.o src/regex.o \
895 src/fcgi.o src/eb32tree.o src/eb32sctree.o src/dynbuf.o src/uri_auth.o \
896 src/hpack-tbl.o src/ebimtree.o src/auth.o src/ebsttree.o \
897 src/ebistree.o src/base64.o src/wdt.o src/pipe.o src/http_acl.o \
898 src/hpack-enc.o src/dict.o src/dgram.o src/init.o src/hpack-huff.o \
899 src/freq_ctr.o src/ebtree.o src/hash.o src/version.o
Willy Tarreau2404e372020-11-05 16:42:25 +0100900
901ifneq ($(TRACE),)
902OBJS += src/calltrace.o
903endif
904
Willy Tarreaub26835d2016-05-30 13:39:32 +0200905# Used only for forced dependency checking. May be cleared during development.
Willy Tarreaufc80e302020-05-27 11:05:33 +0200906INCLUDES = $(wildcard include/*/*.h)
Willy Tarreau8225bb42016-05-30 15:16:10 +0200907DEP = $(INCLUDES) .build_opts
908
William Lallemandf1b60f72018-12-13 14:02:25 +0100909help:
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000910 @sed -ne "/^[^#]*$$/q;s/^# \{0,1\}\(.*\)/\1/;p" Makefile
911 @echo; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200912 if [ -n "$(TARGET)" ]; then \
Willy Tarreau5fb76032019-06-16 19:26:18 +0200913 if [ -n "$(set_target_defaults)" ]; then \
914 echo "Current TARGET: $(TARGET)"; \
915 else \
916 echo "Current TARGET: $(TARGET) (custom target)"; \
917 fi; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200918 else \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200919 echo "TARGET not set, you may pass 'TARGET=xxx' to set one among :";\
Brad Smith382001b2020-10-08 01:15:06 -0400920 echo " linux-glibc, linux-glibc-legacy, solaris, freebsd, dragonfly, netbsd,"; \
921 echo " osx, openbsd, aix51, aix52, aix72-gcc, cygwin, haiku, generic,"; \
922 echo " custom"; \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200923 fi
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000924 @echo;echo "Enabled features for TARGET '$(TARGET)' (disable with 'USE_xxx=') :"
925 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),$(opt),)); echo " $$*" | (fmt || cat) 2>/dev/null
926 @echo;echo "Disabled features for TARGET '$(TARGET)' (enable with 'USE_xxx=1') :"
927 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),,$(opt))); echo " $$*" | (fmt || cat) 2>/dev/null
William Lallemandf1b60f72018-12-13 14:02:25 +0100928
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100929# Used only to force a rebuild if some build options change, but we don't do
930# it for certain targets which take no build options
931ifneq (reg-tests, $(firstword $(MAKECMDGOALS)))
Tim Duesterhus81e948e2020-11-21 18:07:58 +0100932build_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 +0100933.build_opts: $(build_opts)
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100934else
935.build_opts:
936endif
Willy Tarreaub26835d2016-05-30 13:39:32 +0200937
Willy Tarreauff0e8a42020-05-27 10:43:24 +0200938haproxy: $(OPTIONS_OBJS) $(OBJS)
Willy Tarreau16119652018-11-19 08:15:54 +0100939 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
willy tarreau0f7af912005-12-17 12:21:26 +0100940
Willy Tarreaubaaee002006-06-26 02:48:02 +0200941objsize: haproxy
Willy Tarreaub42233a2018-11-19 07:44:42 +0100942 $(Q)objdump -t $^|grep ' g '|grep -F '.text'|awk '{print $$5 FS $$6}'|sort
Willy Tarreaubaaee002006-06-26 02:48:02 +0200943
Willy Tarreaub26835d2016-05-30 13:39:32 +0200944%.o: %.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100945 $(cmd_CC) $(COPTS) -c -o $@ $<
willy tarreau0f7af912005-12-17 12:21:26 +0100946
Willy Tarreaua9f16c62021-04-02 14:46:21 +0200947admin/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
948 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200949
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200950dev/flags/flags: dev/flags/flags.o
951 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200952
Willy Tarreau21ef8b92021-04-02 14:27:26 +0200953dev/hpack/%: dev/hpack/%.o
954 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
955
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200956dev/poll/poll:
957 $(Q)$(MAKE) -C dev/poll poll CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200958
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200959dev/tcploop/tcploop:
960 $(Q)$(MAKE) -C dev/tcploop tcploop CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200961
Willy Tarreau909b9d82019-01-04 18:20:32 +0100962# rebuild it every time
963.PHONY: src/version.c
964
Willy Tarreau9eebd8a2019-08-08 16:53:40 +0200965src/calltrace.o: src/calltrace.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100966 $(cmd_CC) $(TRACE_COPTS) -c -o $@ $<
Willy Tarreau7de211c2012-05-25 23:53:16 +0200967
Willy Tarreaub26835d2016-05-30 13:39:32 +0200968src/haproxy.o: src/haproxy.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100969 $(cmd_CC) $(COPTS) \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100970 -DBUILD_TARGET='"$(strip $(TARGET))"' \
Willy Tarreauef7341d2009-04-11 19:45:50 +0200971 -DBUILD_ARCH='"$(strip $(ARCH))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100972 -DBUILD_CPU='"$(strip $(CPU))"' \
973 -DBUILD_CC='"$(strip $(CC))"' \
974 -DBUILD_CFLAGS='"$(strip $(VERBOSE_CFLAGS))"' \
975 -DBUILD_OPTIONS='"$(strip $(BUILD_OPTIONS))"' \
Tim Duesterhusc8d19702020-11-21 18:07:59 +0100976 -DBUILD_DEBUG='"$(strip $(DEBUG))"' \
Willy Tarreau7728ed32019-03-27 13:20:08 +0100977 -DBUILD_FEATURES='"$(strip $(BUILD_FEATURES))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100978 -c -o $@ $<
Willy Tarreau7b066db2007-12-02 11:28:59 +0100979
Christian Wiese19b50292008-03-12 15:57:54 +0200980install-man:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100981 $(Q)install -v -d "$(DESTDIR)$(MANDIR)"/man1
982 $(Q)install -v -m 644 doc/haproxy.1 "$(DESTDIR)$(MANDIR)"/man1
Christian Wiese19b50292008-03-12 15:57:54 +0200983
Vincent Bernat5c5147f2015-10-13 22:20:55 +0200984EXCLUDE_DOCUMENTATION = lgpl gpl coding-style
985DOCUMENTATION = $(filter-out $(EXCLUDE_DOCUMENTATION),$(patsubst doc/%.txt,%,$(wildcard doc/*.txt)))
986
Christian Wiesebf34eb42008-03-12 17:24:49 +0200987install-doc:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100988 $(Q)install -v -d "$(DESTDIR)$(DOCDIR)"
989 $(Q)for x in $(DOCUMENTATION); do \
990 install -v -m 644 doc/$$x.txt "$(DESTDIR)$(DOCDIR)" ; \
Christian Wiesebf34eb42008-03-12 17:24:49 +0200991 done
992
Willy Tarreau13d67bb2016-06-24 18:30:22 +0200993install-bin:
Willy Tarreaub42233a2018-11-19 07:44:42 +0100994 $(Q)for i in haproxy $(EXTRA); do \
Willy Tarreau13d67bb2016-06-24 18:30:22 +0200995 if ! [ -e "$$i" ]; then \
996 echo "Please run 'make' before 'make install'."; \
997 exit 1; \
998 fi; \
999 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001000 $(Q)install -v -d "$(DESTDIR)$(SBINDIR)"
1001 $(Q)install -v haproxy $(EXTRA) "$(DESTDIR)$(SBINDIR)"
Christian Wiesea184aa22008-03-12 15:25:35 +02001002
Christian Wiesedb5238d2008-03-12 18:28:13 +02001003install: install-bin install-man install-doc
Christian Wiese4cf5d572008-03-12 16:21:05 +02001004
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001005uninstall:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001006 $(Q)rm -f "$(DESTDIR)$(MANDIR)"/man1/haproxy.1
1007 $(Q)for x in $(DOCUMENTATION); do \
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001008 rm -f "$(DESTDIR)$(DOCDIR)"/$$x.txt ; \
1009 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001010 $(Q)-rmdir "$(DESTDIR)$(DOCDIR)"
1011 $(Q)rm -f "$(DESTDIR)$(SBINDIR)"/haproxy
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001012
willy tarreau0f7af912005-12-17 12:21:26 +01001013clean:
Willy Tarreauff0e8a42020-05-27 10:43:24 +02001014 $(Q)rm -f *.[oas] src/*.[oas] haproxy test .build_opts .build_opts.new
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001015 $(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 +02001016 $(Q)rm -f haproxy-$(VERSION).tar.gz haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1017 $(Q)rm -f haproxy-$(VERSION) haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) nohup.out gmon.out
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001018 $(Q)rm -f addons/promex/*.[oas]
Willy Tarreau977209d2021-04-02 16:12:32 +02001019 $(Q)rm -f addons/51degrees/*.[oas] addons/51degrees/dummy/*.[oas] addons/51degrees/dummy/*/*.[oas]
Willy Tarreauf8d9ec52021-04-02 16:19:39 +02001020 $(Q)rm -f addons/deviceatlas/*.[oas] addons/deviceatlas/dummy/*.[oas]
Willy Tarreaua63d1a02021-04-02 17:16:46 +02001021 $(Q)rm -f addons/ot/src/*.[oas]
Willy Tarreau57610c62021-04-02 16:39:44 +02001022 $(Q)rm -f addons/wurfl/*.[oas] addons/wurfl/dummy/*.[oas]
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001023 $(Q)rm -f admin/*/*.[oas] admin/*/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001024 $(Q)rm -f admin/iprange/iprange admin/iprange/ip6range admin/halog/halog
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001025 $(Q)rm -f dev/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001026 $(Q)rm -f dev/flags/flags dev/poll/poll dev/tcploop/tcploop
Willy Tarreau21ef8b92021-04-02 14:27:26 +02001027 $(Q)rm -f dev/hpack/decode dev/hpack/gen-enc dev/hpack/gen-rht
willy tarreauefae1842005-12-17 12:51:03 +01001028
Willy Tarreauebe0af42009-10-10 22:20:44 +02001029tags:
Willy Tarreau6db82662018-11-19 08:14:40 +01001030 $(Q)find src include \( -name '*.c' -o -name '*.h' \) -print0 | \
Willy Tarreauebe0af42009-10-10 22:20:44 +02001031 xargs -0 etags --declarations --members
1032
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001033cscope:
Willy Tarreau6db82662018-11-19 08:14:40 +01001034 $(Q)find src include -name "*.[ch]" -print | cscope -q -b -i -
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001035
willy tarreaue114bf92006-03-19 21:30:14 +01001036tar: clean
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001037 $(Q)ln -s . haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
1038 $(Q)tar --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/.git \
1039 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) \
1040 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz \
1041 -cf - haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/* | gzip -c9 >haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1042 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1043 $(Q)rm -f haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
willy tarreaucee272f2006-03-19 21:16:26 +01001044
Willy Tarreau05ed29c2012-12-20 15:00:44 +01001045git-tar:
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001046 $(Q)git archive --format=tar --prefix="haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/" HEAD | gzip -9 > haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1047 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
Willy Tarreauec692562007-09-09 23:31:11 +02001048
1049version:
1050 @echo "VERSION: $(VERSION)"
1051 @echo "SUBVERS: $(SUBVERS)"
1052 @echo "VERDATE: $(VERDATE)"
1053
1054# never use this one if you don't know what it is used for.
1055update-version:
1056 @echo "Ready to update the following versions :"
1057 @echo "VERSION: $(VERSION)"
1058 @echo "SUBVERS: $(SUBVERS)"
1059 @echo "VERDATE: $(VERDATE)"
1060 @echo "Press [ENTER] to continue or Ctrl-C to abort now.";read
1061 echo "$(VERSION)" > VERSION
1062 echo "$(SUBVERS)" > SUBVERS
1063 echo "$(VERDATE)" > VERDATE
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001064
Willy Tarreaua8b12c62018-10-03 09:40:22 +02001065# just display the build options
1066opts:
1067 @echo -n 'Using: '
1068 @echo -n 'TARGET="$(strip $(TARGET))" '
1069 @echo -n 'ARCH="$(strip $(ARCH))" '
1070 @echo -n 'CPU="$(strip $(CPU))" '
1071 @echo -n 'CC="$(strip $(CC))" '
1072 @echo -n 'ARCH_FLAGS="$(strip $(ARCH_FLAGS))" '
1073 @echo -n 'CPU_CFLAGS="$(strip $(CPU_CFLAGS))" '
1074 @echo -n 'DEBUG_CFLAGS="$(strip $(DEBUG_CFLAGS))" '
1075 @echo "$(strip $(BUILD_OPTIONS))"
1076 @echo 'COPTS="$(strip $(COPTS))"'
1077 @echo 'LDFLAGS="$(strip $(LDFLAGS))"'
1078 @echo 'LDOPTS="$(strip $(LDOPTS))"'
1079 @echo 'OPTIONS_OBJS="$(strip $(OPTIONS_OBJS))"'
1080 @echo 'OBJS="$(strip $(OBJS))"'
1081
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001082ifeq (reg-tests, $(firstword $(MAKECMDGOALS)))
1083 REGTEST_ARGS := $(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))
1084 $(eval $(REGTEST_ARGS):;@true)
1085endif
1086
Frédéric Lécaille99316342018-08-22 10:41:33 +02001087# Target to run the regression testing script files.
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001088reg-tests:
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001089 $(Q)$(REG_TEST_SCRIPT) --type "$(REGTESTS_TYPES)" $(REGTEST_ARGS) $(REG_TEST_FILES)
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001090.PHONY: $(REGTEST_ARGS)
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001091
1092reg-tests-help:
1093 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001094 @echo "To launch the reg tests for haproxy, first export to your environment "
1095 @echo "VTEST_PROGRAM variable to point to your vtest program:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001096 @echo " $$ export VTEST_PROGRAM=/opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001097 @echo "or"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001098 @echo " $$ setenv VTEST_PROGRAM /opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001099 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001100 @echo "The same thing may be done to set your haproxy program with HAPROXY_PROGRAM "
1101 @echo "but with ./haproxy as default value."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001102 @echo
1103 @echo "To run all the tests:"
1104 @echo " $$ make reg-tests"
1105 @echo
1106 @echo "You can also set the programs to be used on the command line:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001107 @echo " $$ VTEST_PROGRAM=<...> HAPROXY_PROGRAM=<...> make reg-tests"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001108 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001109 @echo "To run tests with specific types:"
1110 @echo " $$ REGTESTS_TYPES=slow,default make reg-tests"
1111 @echo
William Lallemandc1ddcaf2021-02-05 11:27:54 +01001112 @echo "with 'default,bug,devel,slow' as default value for REGTESTS_TYPES variable."
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001113 @echo
1114 @echo "About the reg test types:"
1115 @echo " any : all the tests without distinction (this is the default"
1116 @echo " value of REGTESTS_TYPES."
1117 @echo " default : dedicated to pure haproxy compliance tests."
1118 @echo " slow : scripts which take non negligible time to run."
1119 @echo " bug : scripts in relation with bugs they help to reproduce."
1120 @echo " broken : scripts triggering known broken behaviors for which"
1121 @echo " there is still no fix."
1122 @echo " experimental: for scripts which are experimental, typically used to"
1123 @echo " develop new scripts."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001124 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001125 @echo "Note that 'reg-tests' target run '"$(REG_TEST_SCRIPT)"' script"
1126 @echo "(see --help option of this script for more information)."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001127
1128.PHONY: reg-tests reg-tests-help