blob: 0bf04f4ecadfdf481f98f95c0e904224f492ae61 [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.
Christopher Fauleta1ae7e82017-10-25 17:55:27 +020025# USE_THREAD : enable threads support.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010026# USE_STATIC_PCRE : enable static libpcre. Recommended.
David Carlierf2592b22016-11-21 21:25:58 +000027# USE_STATIC_PCRE2 : enable static libpcre2.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010028# USE_TPROXY : enable transparent proxy. Automatic.
Willy Tarreaue0c623d2012-06-04 00:42:09 +020029# USE_LINUX_TPROXY : enable full transparent proxy. Automatic.
30# USE_LINUX_SPLICE : enable kernel 2.6 splicing. Automatic.
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -070031# USE_LIBCRYPT : enable encrypted passwords using -lcrypt
Willy Tarreau890a33e2010-03-04 19:10:14 +010032# USE_CRYPT_H : set it if your system requires including crypt.h
Willy Tarreau64bc40b2011-03-23 20:00:53 +010033# USE_GETADDRINFO : use getaddrinfo() to resolve IPv6 host names.
Emeric Brun7444f012012-05-18 15:48:30 +020034# USE_OPENSSL : enable use of OpenSSL. Recommended, but see below.
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +010035# USE_LUA : enable Lua support.
Willy Tarreau1bc4aab2012-10-08 20:11:03 +020036# USE_ACCEPT4 : enable use of accept4() on linux. Automatic.
Brad Smith5018aac2020-09-30 01:04:48 -040037# USE_CLOSEFROM : enable use of closefrom() on *bsd, solaris. Automatic.
Willy Tarreau636848a2019-04-15 19:38:50 +020038# USE_PRCTL : enable use of prctl(). Automatic.
devnexen@gmail.com21185972021-08-21 09:13:10 +010039# USE_PROCCTL : enable use of procctl(). Automatic.
Willy Tarreau12840be2021-04-22 14:14:22 +020040# USE_ZLIB : enable zlib library support and disable SLZ
41# USE_SLZ : enable slz library instead of zlib (default=enabled)
Willy Tarreaufc6c0322012-11-16 16:12:27 +010042# USE_CPU_AFFINITY : enable pinning processes to CPU on Linux. Automatic.
Lukas Tribus0999f762013-04-02 16:43:24 +020043# USE_TFO : enable TCP fast open. Supported on Linux >= 3.7.
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +010044# USE_NS : enable network namespace support. Supported on Linux >= 2.6.24.
Willy Tarreau71b99ef2015-03-17 14:33:22 +010045# USE_DL : enable it if your system requires -ldl. Automatic on Linux.
Willy Tarreau58e90cb2018-10-18 16:28:54 +020046# USE_RT : enable it if your system requires -lrt. Automatic on Linux.
Willy Tarreauf5b4e062020-03-03 15:40:23 +010047# USE_BACKTRACE : enable backtrace(). Automatic on Linux.
Willy Tarreau92dc7862021-04-02 15:31:10 +020048# USE_PROMEX : enable the Prometheus exporter
David Carliera03fb142015-06-01 14:00:07 +020049# USE_DEVICEATLAS : enable DeviceAtlas api.
Dragan Dosen93b38d92015-06-29 16:43:25 +020050# USE_51DEGREES : enable third party device detection library from 51Degrees
Willy Tarreaub3cc9f22019-04-19 16:03:32 +020051# USE_WURFL : enable WURFL detection library from Scientiamobile
Tim Duesterhusd6942c82017-11-20 15:58:35 +010052# USE_SYSTEMD : enable sd_notify() support.
Willy Tarreau7b5654f2019-03-29 21:30:17 +010053# USE_OBSOLETE_LINKER : use when the linker fails to emit __start_init/__stop_init
Willy Tarreauc7091d82019-05-17 10:08:49 +020054# USE_THREAD_DUMP : use the more advanced thread state dump system. Automatic.
Miroslav Zagorac70230c62020-12-09 16:54:31 +010055# USE_OT : enable the OpenTracing filter
Willy Tarreauf6818d62021-05-05 18:17:39 +020056# USE_MEMORY_PROFILING : enable the memory profiler. Linux-glibc only.
Willy Tarreau70c268b2021-11-14 15:28:38 +010057# USE_LIBATOMIC : force to link with/without libatomic. Automatic.
Willy Tarreauf2ef8c52007-07-11 09:19:31 +020058#
Willy Tarreau9f2b7302008-01-02 20:48:34 +010059# Options can be forced by specifying "USE_xxx=1" or can be disabled by using
Willy Tarreau50b1aae2019-06-14 15:52:01 +020060# "USE_xxx=" (empty string). The list of enabled and disabled options for a
61# given TARGET is enumerated at the end of "make help".
Willy Tarreau9f2b7302008-01-02 20:48:34 +010062#
63# Variables useful for packagers :
Brad Smith94636432020-09-13 02:53:06 -040064# CC is set to "cc" by default and is used for compilation only.
65# LD is set to "cc" by default and is used for linking only.
Willy Tarreauef7341d2009-04-11 19:45:50 +020066# ARCH may be useful to force build of 32-bit binary on 64-bit systems
Willy Tarreau9f2b7302008-01-02 20:48:34 +010067# CFLAGS is automatically set for the specified CPU and may be overridden.
68# LDFLAGS is automatically set to -g and may be overridden.
Willy Tarreaub26835d2016-05-30 13:39:32 +020069# DEP may be cleared to ignore changes to include files during development
Willy Tarreau9f2b7302008-01-02 20:48:34 +010070# SMALL_OPTS may be used to specify some options to shrink memory usage.
71# DEBUG may be used to set some internal debugging options.
Willy Tarreau23cd43e2018-10-22 06:22:46 +020072# ERR may be set to non-empty to pass -Werror to the compiler
Willy Tarreau9f2b7302008-01-02 20:48:34 +010073# ADDINC may be used to complete the include path in the form -Ipath.
74# ADDLIB may be used to complete the library list in the form -Lpath -llib.
75# DEFINE may be used to specify any additional define, which will be reported
76# by "haproxy -vv" in CFLAGS.
77# SILENT_DEFINE may be used to specify other defines which will not be
78# reported by "haproxy -vv".
William Lallemanda6cfa902017-06-01 17:38:58 +020079# EXTRA is used to force building or not building some extra tools.
Christian Wiesea184aa22008-03-12 15:25:35 +020080# DESTDIR is not set by default and is used for installation only.
81# It might be useful to set DESTDIR if you want to install haproxy
82# in a sandbox.
83# PREFIX is set to "/usr/local" by default and is used for installation only.
84# SBINDIR is set to "$(PREFIX)/sbin" by default and is used for installation
85# only.
Christian Wiese19b50292008-03-12 15:57:54 +020086# MANDIR is set to "$(PREFIX)/share/man" by default and is used for
87# installation only.
Christian Wiesebf34eb42008-03-12 17:24:49 +020088# DOCDIR is set to "$(PREFIX)/doc/haproxy" by default and is used for
89# installation only.
Tim Duesterhus541fe1e2020-01-12 13:55:41 +010090# HLUA_PREPEND_PATH may be used to prepend a folder to Lua's default package.path.
91# HLUA_PREPEND_CPATH may be used to prepend a folder to Lua's default package.cpath.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010092#
93# Other variables :
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +020094# PCRE_CONFIG : force the binary path to get pcre config (by default
95# pcre-config)
Willy Tarreau9f2b7302008-01-02 20:48:34 +010096# PCREDIR : force the path to libpcre.
Willy Tarreau39793092013-02-13 12:39:06 +010097# PCRE_LIB : force the lib path to libpcre (defaults to $PCREDIR/lib).
98# PCRE_INC : force the include path to libpcre ($PCREDIR/inc)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +020099# PCRE2_CONFIG : force the binary path to get pcre2 config (by default
100# pcre2-config)
Willy Tarreau9a059452013-09-17 15:26:39 +0200101# SSL_LIB : force the lib path to libssl/libcrypto
102# SSL_INC : force the include path to libssl/libcrypto
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100103# LUA_LIB : force the lib path to lua
104# LUA_INC : force the include path to lua
Cyril Bontéc21adb52015-03-03 23:13:03 +0100105# LUA_LIB_NAME : force the lib name (or automatically evaluated, by order of
Thierry FOURNIERf90838b2015-03-06 13:48:32 +0100106# priority : lua5.3, lua53, lua).
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100107# OT_DEBUG : compile the OpenTracing filter in debug mode
108# OT_INC : force the include path to libopentracing-c-wrapper
109# OT_LIB : force the lib path to libopentracing-c-wrapper
110# OT_RUNPATH : add RUNPATH for libopentracing-c-wrapper to haproxy executable
Miroslav Zagorac4cb2c832021-09-08 20:56:05 +0200111# OT_USE_VARS : allows the use of variables for the OpenTracing context
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 Tarreau28e295d2021-08-30 06:02:47 +0200196SPEC_CFLAGS := -Wall -Wextra -Wundef -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 Tarreau790169f2022-01-07 14:51:56 +0100206SPEC_CFLAGS += $(call cc-nowarn,atomic-alignment)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200207SPEC_CFLAGS += $(call cc-opt,-Wtype-limits)
208SPEC_CFLAGS += $(call cc-opt,-Wshift-negative-value)
209SPEC_CFLAGS += $(call cc-opt,-Wshift-overflow=2)
210SPEC_CFLAGS += $(call cc-opt,-Wduplicated-cond)
211SPEC_CFLAGS += $(call cc-opt,-Wnull-dereference)
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100212
Willy Tarreau4b61e692020-03-10 09:37:08 +0100213ifneq ($(ERR),)
214SPEC_CFLAGS += -Werror
215endif
216
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100217#### Memory usage tuning
218# If small memory footprint is required, you can reduce the buffer size. There
219# are 2 buffers per concurrent session, so 16 kB buffers will eat 32 MB memory
220# with 1000 concurrent sessions. Putting it slightly lower than a page size
221# will prevent the additional parameters to go beyond a page. 8030 bytes is
222# exactly 5.5 TCP segments of 1460 bytes and is generally good. Useful tuning
223# macros include :
224# SYSTEM_MAXCONN, BUFSIZE, MAXREWRITE, REQURI_LEN, CAPTURE_LEN.
225# Example: SMALL_OPTS = -DBUFSIZE=8030 -DMAXREWRITE=1030 -DSYSTEM_MAXCONN=1024
226SMALL_OPTS =
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100227
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100228#### Debug settings
229# You can enable debugging on specific code parts by setting DEBUG=-DDEBUG_xxx.
Willy Tarreau4c442b02020-07-04 12:43:46 +0200230# Use quotes and spaces if multiple options are needed (the DEBUG variables is
231# passed as-is to CFLAGS). Please check sources for their exact meaning or do
232# not use them at all. Some even more obscure ones might also be available
233# without appearing here. Currently defined DEBUG macros include DEBUG_FULL,
Willy Tarreau8715dec2021-06-10 17:31:48 +0200234# DEBUG_MEM_STATS, DEBUG_DONT_SHARE_POOLS, DEBUG_FD,
Willy Tarreau2d6f6282021-04-15 16:24:00 +0200235# DEBUG_NO_POOLS, DEBUG_FAIL_ALLOC, DEBUG_STRICT_NOCRASH, DEBUG_HPACK,
Willy Tarreaub23f0422021-02-16 18:44:00 +0100236# DEBUG_AUTH, DEBUG_SPOE, DEBUG_UAF, DEBUG_THREAD, DEBUG_STRICT, DEBUG_DEV,
William Lallemanddbee2e52021-09-29 16:03:35 +0200237# DEBUG_TASK, DEBUG_MEMORY_POOLS.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100238DEBUG =
willy tarreau1c2ad212005-12-18 01:11:29 +0100239
Willy Tarreau7de211c2012-05-25 23:53:16 +0200240#### Trace options
241# Use TRACE=1 to trace function calls to file "trace.out" or to stderr if not
242# possible.
243TRACE =
244
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100245#### Additional include and library dirs
246# Redefine this if you want to add some special PATH to include/libs
247ADDINC =
248ADDLIB =
willy tarreau64a3cc32005-12-18 01:13:11 +0100249
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100250#### Specific macro definitions
251# Use DEFINE=-Dxxx to set any tunable macro. Anything declared here will appear
252# in the build options reported by "haproxy -vv". Use SILENT_DEFINE if you do
253# not want to pollute the report with complex defines.
Emeric Brun76d88952012-10-05 15:47:31 +0200254# The following settings might be of interest when SSL is enabled :
255# LISTEN_DEFAULT_CIPHERS is a cipher suite string used to set the default SSL
256# ciphers on "bind" lines instead of using OpenSSL's defaults.
257# CONNECT_DEFAULT_CIPHERS is a cipher suite string used to set the default
258# SSL ciphers on "server" lines instead of using OpenSSL's defaults.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100259DEFINE =
260SILENT_DEFINE =
willy tarreau0f7af912005-12-17 12:21:26 +0100261
William Lallemanda6cfa902017-06-01 17:38:58 +0200262#### extra programs to build
Willy Tarreaubc289da2014-05-10 12:16:21 +0200263# Force this to enable building extra programs or to disable them.
264# It's automatically appended depending on the targets.
265EXTRA =
willy tarreau5cbea6f2005-12-17 12:48:26 +0100266
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500267#### CPU dependent optimizations
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100268# Some CFLAGS are set by default depending on the target CPU. Those flags only
269# feed CPU_CFLAGS, which in turn feed CFLAGS, so it is not mandatory to use
270# them. You should not have to change these options. Better use CPU_CFLAGS or
271# even CFLAGS instead.
272CPU_CFLAGS.generic = -O2
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100273CPU_CFLAGS.native = -O2 -march=native
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100274CPU_CFLAGS.i586 = -O2 -march=i586
275CPU_CFLAGS.i686 = -O2 -march=i686
276CPU_CFLAGS.ultrasparc = -O6 -mcpu=v9 -mtune=ultrasparc
Christian Lachnerc1322302020-02-10 10:29:13 +0100277CPU_CFLAGS.power8 = -O2 -mcpu=power8 -mtune=power8
278CPU_CFLAGS.power9 = -O2 -mcpu=power9 -mtune=power9
Willy Tarreau40a871f2021-05-12 09:47:30 +0200279CPU_CFLAGS.a53 = -O2 -mcpu=cortex-a53
280CPU_CFLAGS.a72 = -O2 -mcpu=cortex-a72
281CPU_CFLAGS.armv81 = -O2 -march=armv8.1-a
282CPU_CFLAGS.armv8-auto = -O2 -march=armv8-a+crc -moutline-atomics
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100283CPU_CFLAGS = $(CPU_CFLAGS.$(CPU))
willy tarreau9da061b2005-12-17 12:29:56 +0100284
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500285#### ARCH dependent flags, may be overridden by CPU flags
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100286ARCH_FLAGS.32 = -m32
287ARCH_FLAGS.64 = -m64
Willy Tarreauef7341d2009-04-11 19:45:50 +0200288ARCH_FLAGS.i386 = -m32 -march=i386
289ARCH_FLAGS.i486 = -m32 -march=i486
290ARCH_FLAGS.i586 = -m32 -march=i586
291ARCH_FLAGS.i686 = -m32 -march=i686
292ARCH_FLAGS.x86_64 = -m64 -march=x86-64
293ARCH_FLAGS = $(ARCH_FLAGS.$(ARCH))
294
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100295#### Common CFLAGS
296# These CFLAGS contain general optimization options, CPU-specific optimizations
297# and debug flags. They may be overridden by some distributions which prefer to
298# set all of them at once instead of playing with the CPU and DEBUG variables.
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100299CFLAGS = $(ARCH_FLAGS) $(CPU_CFLAGS) $(DEBUG_CFLAGS) $(SPEC_CFLAGS)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100300
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100301#### Common LDFLAGS
302# These LDFLAGS are used as the first "ld" options, regardless of any library
303# path or any other option. They may be changed to add any linker-specific
304# option at the beginning of the ld command line.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200305LDFLAGS = $(ARCH_FLAGS) -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100306
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100307#### list of all "USE_*" options. These ones must be updated if new options are
308# added, so that the relevant options are properly added to the CFLAGS and to
309# the reported build options.
Willy Tarreau06c63ae2020-03-10 07:20:10 +0100310use_opts = USE_EPOLL USE_KQUEUE USE_NETFILTER \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100311 USE_PCRE USE_PCRE_JIT USE_PCRE2 USE_PCRE2_JIT USE_POLL \
Willy Tarreau6fd04502021-06-15 16:11:33 +0200312 USE_THREAD USE_BACKTRACE \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100313 USE_STATIC_PCRE USE_STATIC_PCRE2 USE_TPROXY USE_LINUX_TPROXY \
Willy Tarreauc3e926b2020-03-10 06:48:17 +0100314 USE_LINUX_SPLICE USE_LIBCRYPT USE_CRYPT_H \
Willy Tarreau6fd04502021-06-15 16:11:33 +0200315 USE_GETADDRINFO USE_OPENSSL USE_LUA USE_ACCEPT4 \
Brad Smith5018aac2020-09-30 01:04:48 -0400316 USE_CLOSEFROM USE_ZLIB USE_SLZ USE_CPU_AFFINITY USE_TFO USE_NS \
Willy Tarreau14261982019-04-23 10:57:09 +0200317 USE_DL USE_RT USE_DEVICEATLAS USE_51DEGREES USE_WURFL USE_SYSTEMD \
devnexen@gmail.com21185972021-08-21 09:13:10 +0100318 USE_OBSOLETE_LINKER USE_PRCTL USE_PROCCTL USE_THREAD_DUMP \
319 USE_EVPORTS USE_OT USE_QUIC USE_PROMEX USE_MEMORY_PROFILING
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100320
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100321#### Target system options
322# Depending on the target platform, some options are set, as well as some
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100323# CFLAGS and LDFLAGS. All variables pre-set here will not appear in the build
324# options string. They may be set to any value, but are historically set to
325# "implicit" which eases debugging. You should not have to change anything
326# there unless you're adding support for a new platform.
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100327default_opts = $(foreach name,$(1),$(eval $(name)=implicit))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100328
329# poll() is always supported, unless explicitly disabled by passing USE_POLL=""
330# on the make command line.
Willy Tarreau32e65ef2013-04-02 08:14:29 +0200331USE_POLL = default
332
Willy Tarreau12840be2021-04-22 14:14:22 +0200333# SLZ is always supported unless explicitly disabled by passing USE_SLZ=""
334# or disabled by enabling ZLIB using USE_ZLIB=1
335ifeq ($(USE_ZLIB),)
336USE_SLZ = default
337endif
338
Willy Tarreau39f19922019-03-27 11:44:19 +0100339# generic system target has nothing specific
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100340ifeq ($(TARGET),generic)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100341 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY)
Willy Tarreau39f19922019-03-27 11:44:19 +0100342endif
343
344# Haiku
Jerome Duval38932c32015-10-19 23:01:16 +0000345ifeq ($(TARGET),haiku)
Jerome Duval38932c32015-10-19 23:01:16 +0000346 TARGET_LDFLAGS = -lnetwork
David Carlier953771b2021-06-19 14:42:43 +0000347 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Willy Tarreau39f19922019-03-27 11:44:19 +0100348endif
349
Willy Tarreau61cf0dc2019-06-14 16:32:09 +0200350# For linux >= 2.6.28 and glibc
351ifeq ($(TARGET),linux-glibc)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100352 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100353 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
Willy Tarreau6fd04502021-06-15 16:11:33 +0200354 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_LINUX_TPROXY \
Willy Tarreau364d6f52019-06-14 18:33:56 +0200355 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100356 USE_GETADDRINFO USE_BACKTRACE)
Willy Tarreau39f19922019-03-27 11:44:19 +0100357endif
358
Lukas Tribuscc1eb162019-09-01 16:48:36 +0200359# For linux >= 2.6.28, glibc without new features
360ifeq ($(TARGET),linux-glibc-legacy)
361 set_target_defaults = $(call default_opts, \
362 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
Willy Tarreau6fd04502021-06-15 16:11:33 +0200363 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_LINUX_TPROXY \
Lukas Tribuscc1eb162019-09-01 16:48:36 +0200364 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_GETADDRINFO)
365endif
366
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200367# For linux >= 2.6.28 and musl
368ifeq ($(TARGET),linux-musl)
369 set_target_defaults = $(call default_opts, \
370 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
Willy Tarreau6fd04502021-06-15 16:11:33 +0200371 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_LINUX_TPROXY \
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200372 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
373 USE_GETADDRINFO)
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200374endif
375
Brad Smith7c503bb2020-09-30 15:46:16 -0400376# Solaris 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100377ifeq ($(TARGET),solaris)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100378 set_target_defaults = $(call default_opts, \
Emmanuel Hocdet7093c192019-05-21 09:12:03 +0000379 USE_POLL USE_TPROXY USE_LIBCRYPT USE_CRYPT_H USE_GETADDRINFO USE_THREAD \
Brad Smith7c503bb2020-09-30 15:46:16 -0400380 USE_RT USE_OBSOLETE_LINKER USE_EVPORTS USE_CLOSEFROM)
Emmanuel Hocdet3c0edfa2019-05-17 15:32:21 +0000381 TARGET_CFLAGS = -DFD_SETSIZE=65536 -D_REENTRANT -D_XOPEN_SOURCE=500 -D__EXTENSIONS__
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100382 TARGET_LDFLAGS = -lnsl -lsocket
Willy Tarreau39f19922019-03-27 11:44:19 +0100383endif
384
Brad Smith9d85eb02020-09-15 03:10:04 -0400385# FreeBSD 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100386ifeq ($(TARGET),freebsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100387 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100388 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
devnexen@gmail.com21185972021-08-21 09:13:10 +0100389 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO USE_PROCCTL)
Willy Tarreau39f19922019-03-27 11:44:19 +0100390endif
391
Brad Smith382001b2020-10-08 01:15:06 -0400392# DragonFlyBSD 4.3 and above
393ifeq ($(TARGET),dragonfly)
394 set_target_defaults = $(call default_opts, \
395 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
396 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO)
397endif
398
Willy Tarreau39f19922019-03-27 11:44:19 +0100399# Mac OS/X
Willy Tarreau8624cab2013-04-02 08:17:43 +0200400ifeq ($(TARGET),osx)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100401 set_target_defaults = $(call default_opts, \
Brad Smithad5afba2020-10-09 19:26:23 -0400402 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
403 USE_GETADDRINFO)
Willy Tarreaub684e7a2018-03-05 15:37:04 +0100404 EXPORT_SYMBOL = -export_dynamic
Willy Tarreau39f19922019-03-27 11:44:19 +0100405endif
406
Brad Smith90c9d782020-09-26 23:05:25 -0400407# OpenBSD 6.3 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100408ifeq ($(TARGET),openbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100409 set_target_defaults = $(call default_opts, \
Matthieu Guegan496374e2020-11-20 10:50:39 +0100410 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_KQUEUE USE_ACCEPT4 \
411 USE_CLOSEFROM USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100412endif
413
Brad Smith0fdfe412020-10-08 16:24:52 -0400414# NetBSD 8 and above
David Carlierb5714da2015-07-02 06:58:22 +0000415ifeq ($(TARGET),netbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100416 set_target_defaults = $(call default_opts, \
Brad Smith0fdfe412020-10-08 16:24:52 -0400417 USE_POLL USE_TPROXY USE_THREAD USE_KQUEUE USE_ACCEPT4 USE_CLOSEFROM \
418 USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100419endif
420
421# AIX 5.1 only
Willy Tarreau50abe302014-04-02 20:44:43 +0200422ifeq ($(TARGET),aix51)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100423 set_target_defaults = $(call default_opts, \
Willy Tarreau6fd04502021-06-15 16:11:33 +0200424 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER)
Willy Tarreau0aed6ac2019-03-29 18:56:00 +0100425 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 +0200426 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100427endif
428
Christian Lachnerc1322302020-02-10 10:29:13 +0100429# AIX 5.2
Willy Tarreau7dec9652012-06-06 16:15:03 +0200430ifeq ($(TARGET),aix52)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100431 set_target_defaults = $(call default_opts, \
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100432 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER)
Willy Tarreau7dec9652012-06-06 16:15:03 +0200433 TARGET_CFLAGS = -D_MSGQSUPPORT
434 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100435endif
436
Christian Lachnerc1322302020-02-10 10:29:13 +0100437# AIX 7.2 and above
438ifeq ($(TARGET),aix72-gcc)
439 set_target_defaults = $(call default_opts, \
440 USE_POLL USE_THREAD USE_LIBCRYPT USE_OBSOLETE_LINKER USE_GETADDRINFO)
441 TARGET_CFLAGS = -D_H_XMEM -D_H_VAR
442 TARGET_LDFLAGS = -latomic
443endif
444
Willy Tarreau39f19922019-03-27 11:44:19 +0100445# Cygwin
Yitzhak Sapir32087312009-06-14 18:27:54 +0200446ifeq ($(TARGET),cygwin)
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100447 set_target_defaults = $(call default_opts, \
448 USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -0700449 # Cygwin adds IPv6 support only in version 1.7 (in beta right now).
Yitzhak Sapir32087312009-06-14 18:27:54 +0200450 TARGET_CFLAGS = $(if $(filter 1.5.%, $(shell uname -r)), -DUSE_IPV6 -DAF_INET6=23 -DINET6_ADDRSTRLEN=46, )
Willy Tarreau39f19922019-03-27 11:44:19 +0100451endif
willy tarreau4373b962005-12-18 01:32:31 +0100452
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100453# set the default settings according to the target above
454$(set_target_defaults)
455
Willy Tarreau70c268b2021-11-14 15:28:38 +0100456# Some architectures require to link with libatomic for atomics of certain
457# sizes. These ones are reported as value 1 in the *_LOCK_FREE macros. Value
458# 2 indicates that the builtin is native thus doesn't require libatomic. Hence
459# any occurrence of 1 indicates libatomic is necessary. It's better to avoid
460# linking with it by default as it's not always available nor deployed
461# (especially on archs which do not need it).
462ifneq ($(USE_THREAD),)
463ifneq ($(shell $(CC) $(CFLAGS) -dM -E -xc - </dev/null 2>/dev/null | grep -c 'LOCK_FREE.*1'),0)
464 USE_LIBATOMIC=1
465endif
466endif
467
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100468#### Determine version, sub-version and release date.
469# If GIT is found, and IGNOREGIT is not set, VERSION, SUBVERS and VERDATE are
470# extracted from the last commit. Otherwise, use the contents of the files
471# holding the same names in the current directory.
willy tarreau0174f312005-12-18 01:02:42 +0100472
Willy Tarreau6620dbb2007-01-02 00:44:53 +0100473ifeq ($(IGNOREGIT),)
Willy Tarreau3c55efb2019-06-22 08:24:16 +0200474VERSION := $(shell [ -d .git/. ] && (git describe --tags --match 'v*' --abbrev=0 | cut -c 2-) 2>/dev/null)
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100475ifneq ($(VERSION),)
476# OK git is there and works.
Willy Tarreau30a6f642019-06-22 07:51:02 +0200477SUBVERS := $(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 +0100478VERDATE := $(shell git log -1 --pretty=format:%ci | cut -f1 -d' ' | tr '-' '/')
Willy Tarreauec692562007-09-09 23:31:11 +0200479endif
480endif
481
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100482# Last commit version not found, take it from the files.
Willy Tarreauec692562007-09-09 23:31:11 +0200483ifeq ($(VERSION),)
484VERSION := $(shell cat VERSION 2>/dev/null || touch VERSION)
485endif
486ifeq ($(SUBVERS),)
Willy Tarreau6173bbe2013-12-16 01:34:39 +0100487SUBVERS := $(shell (grep -v '\$$Format' SUBVERS 2>/dev/null || touch SUBVERS) | head -n 1)
Willy Tarreauec692562007-09-09 23:31:11 +0200488endif
489ifeq ($(VERDATE),)
Willy Tarreauf1ed3272014-01-26 00:39:22 +0100490VERDATE := $(shell (grep -v '^\$$Format' VERDATE 2>/dev/null || touch VERDATE) | head -n 1 | cut -f1 -d' ' | tr '-' '/')
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100491endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100492
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200493# this one is always empty by default and appended verbatim
494EXTRAVERSION =
495
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100496#### Build options
497# Do not change these ones, enable USE_* variables instead.
498OPTIONS_CFLAGS =
499OPTIONS_LDFLAGS =
500OPTIONS_OBJS =
Willy Tarreau77074d52006-11-12 23:57:19 +0100501
Willy Tarreauada5d092019-01-10 10:01:03 +0100502#### Extra objects to be built and integrated (used only for development)
503EXTRA_OBJS =
504
Willy Tarreau09fe5662019-03-27 10:36:35 +0100505# Return USE_xxx=$(USE_xxx) if the variable was set from the environment or the
506# command line.
507# Usage:
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100508# BUILD_OPTIONS += $(call ignore_implicit,USE_xxx)
Willy Tarreau09fe5662019-03-27 10:36:35 +0100509ignore_implicit = $(if $(subst environment,,$(origin $(1))), \
510 $(if $(subst command line,,$(origin $(1))),, \
511 $(1)=$($(1))), \
512 $(1)=$($(1))) \
Willy Tarreau77074d52006-11-12 23:57:19 +0100513
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100514# This variable collects all USE_* values except those set to "implicit". This
515# is used to report a list of all flags which were used to build this version.
516# Do not assign anything to it.
Willy Tarreau7728ed32019-03-27 13:20:08 +0100517BUILD_OPTIONS := $(foreach opt,$(use_opts),$(call ignore_implicit,$(opt)))
518BUILD_FEATURES := $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),+$(opt),-$(opt)))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100519
Willy Tarreau824cd002019-03-27 14:44:14 +0100520# All USE_* options have their equivalent macro defined in the code (some might
521# possibly be unused though)
522OPTIONS_CFLAGS += $(foreach opt,$(use_opts),$(if $($(opt)),-D$(opt),))
523
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100524ifneq ($(USE_LIBCRYPT),)
Matthieu Guegan496374e2020-11-20 10:50:39 +0100525ifneq ($(TARGET),openbsd)
David Carlier6c00eba2019-09-01 14:59:10 +0100526ifneq ($(TARGET),osx)
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100527OPTIONS_LDFLAGS += -lcrypt
528endif
David Carlier6c00eba2019-09-01 14:59:10 +0100529endif
Matthieu Guegan496374e2020-11-20 10:50:39 +0100530endif
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100531
William Lallemand82fe75c2012-10-23 10:25:10 +0200532ifneq ($(USE_ZLIB),)
Willy Tarreaue2f49442012-02-10 20:37:26 +0100533# Use ZLIB_INC and ZLIB_LIB to force path to zlib.h and libz.{a,so} if needed.
534ZLIB_INC =
535ZLIB_LIB =
Willy Tarreau824cd002019-03-27 14:44:14 +0100536OPTIONS_CFLAGS += $(if $(ZLIB_INC),-I$(ZLIB_INC))
Willy Tarreaue2f49442012-02-10 20:37:26 +0100537OPTIONS_LDFLAGS += $(if $(ZLIB_LIB),-L$(ZLIB_LIB)) -lz
William Lallemand82fe75c2012-10-23 10:25:10 +0200538endif
539
Willy Tarreau12840be2021-04-22 14:14:22 +0200540ifneq ($(USE_SLZ),)
541OPTIONS_OBJS += src/slz.o
542endif
543
Willy Tarreau77074d52006-11-12 23:57:19 +0100544ifneq ($(USE_POLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100545OPTIONS_OBJS += src/ev_poll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100546endif
547
548ifneq ($(USE_EPOLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100549OPTIONS_OBJS += src/ev_epoll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100550endif
551
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100552ifneq ($(USE_KQUEUE),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100553OPTIONS_OBJS += src/ev_kqueue.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100554endif
555
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000556ifneq ($(USE_EVPORTS),)
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000557OPTIONS_OBJS += src/ev_evports.o
558endif
559
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100560ifneq ($(USE_DL),)
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100561OPTIONS_LDFLAGS += -ldl
562endif
563
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200564ifneq ($(USE_RT),)
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200565OPTIONS_LDFLAGS += -lrt
566endif
567
Willy Tarreauc0bbdc12020-03-04 08:31:47 +0100568ifneq ($(USE_THREAD),)
569OPTIONS_LDFLAGS += -lpthread
570endif
571
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100572ifneq ($(USE_BACKTRACE),)
573OPTIONS_LDFLAGS += -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic)
574endif
575
Amaury Denoyellef75c6402021-04-14 15:03:51 +0200576ifneq ($(USE_CPU_AFFINITY),)
577OPTIONS_OBJS += src/cpuset.o
578endif
579
Emeric Brun7444f012012-05-18 15:48:30 +0200580ifneq ($(USE_OPENSSL),)
Ilya Shipitsinf21023e2020-08-04 15:36:24 +0500581SSL_INC =
582SSL_LIB =
David CARLIER7385f652015-11-06 15:13:06 +0000583# OpenSSL is packaged in various forms and with various dependencies.
Emeric Brun7444f012012-05-18 15:48:30 +0200584# In general -lssl is enough, but on some platforms, -lcrypto may be needed,
Willy Tarreau8f182d92012-09-10 09:11:22 +0200585# reason why it's added by default. Some even need -lz, then you'll need to
Willy Tarreau9a059452013-09-17 15:26:39 +0200586# pass it in the "ADDLIB" variable if needed. If your SSL libraries are not
587# in the usual path, use SSL_INC=/path/to/inc and SSL_LIB=/path/to/lib.
Willy Tarreau824cd002019-03-27 14:44:14 +0100588OPTIONS_CFLAGS += $(if $(SSL_INC),-I$(SSL_INC))
Willy Tarreaucd360ce2014-10-31 07:36:51 +0100589OPTIONS_LDFLAGS += $(if $(SSL_LIB),-L$(SSL_LIB)) -lssl -lcrypto
Dirkjan Bussink1866d6d2016-08-29 13:26:37 +0200590ifneq ($(USE_DL),)
591OPTIONS_LDFLAGS += -ldl
592endif
Remi Tricot-Le Breton7feb3612021-10-01 15:36:54 +0200593OPTIONS_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 src/jwt.o
William Lallemandb620e982017-11-02 16:00:51 +0100594endif
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100595ifneq ($(USE_QUIC),)
596OPTIONS_OBJS += src/quic_sock.o src/proto_quic.o src/xprt_quic.o src/quic_tls.o \
Frédéric Lécaille11c304d2021-05-25 09:12:35 +0200597 src/quic_frame.o src/quic_cc.o src/quic_cc_newreno.o src/mux_quic.o \
Amaury Denoyelle154bc7f2021-11-12 16:09:54 +0100598 src/cbuf.o src/qpack-dec.o src/qpack-tbl.o src/h3.o src/qpack-enc.o \
Amaury Denoyellec8b4ce42022-01-11 11:54:59 +0100599 src/hq_interop.o src/cfgparse-quic.o
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100600endif
William Lallemandb620e982017-11-02 16:00:51 +0100601
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100602ifneq ($(USE_LUA),)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100603check_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 +0800604check_lua_inc = $(shell if [ -d $(2)$(1) ]; then echo $(2)$(1); fi;)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100605
Willy Tarreau824cd002019-03-27 14:44:14 +0100606OPTIONS_CFLAGS += $(if $(LUA_INC),-I$(LUA_INC))
Thierry Fournier13113d62018-02-26 09:25:56 +0100607LUA_LD_FLAGS := -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic) $(if $(LUA_LIB),-L$(LUA_LIB))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100608ifeq ($(LUA_LIB_NAME),)
609# Try to automatically detect the Lua library
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100610LUA_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 +0100611ifeq ($(LUA_LIB_NAME),)
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100612$(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 +0100613endif
Nan Liub286fff2017-06-09 15:57:45 +0800614LUA_INC := $(firstword $(foreach lib,lua5.3 lua53 lua,$(call check_lua_inc,$(lib),"/usr/include/")))
615ifneq ($(LUA_INC),)
616OPTIONS_CFLAGS += -I$(LUA_INC)
617endif
Tim Duesterhus541fe1e2020-01-12 13:55:41 +0100618ifneq ($(HLUA_PREPEND_PATH),)
619OPTIONS_CFLAGS += -DHLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
620BUILD_OPTIONS += HLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
621endif
622ifneq ($(HLUA_PREPEND_CPATH),)
623OPTIONS_CFLAGS += -DHLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
624BUILD_OPTIONS += HLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
625endif
Cyril Bontéc21adb52015-03-03 23:13:03 +0100626endif
627
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100628OPTIONS_LDFLAGS += $(LUA_LD_FLAGS) -l$(LUA_LIB_NAME) -lm
Vincent Bernate192cbb2015-07-16 20:52:51 +0200629ifneq ($(USE_DL),)
630OPTIONS_LDFLAGS += -ldl
631endif
Thierry Fournierfb0b5462016-01-21 09:28:58 +0100632OPTIONS_OBJS += src/hlua.o src/hlua_fcn.o
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100633endif
634
Willy Tarreau92dc7862021-04-02 15:31:10 +0200635ifneq ($(USE_PROMEX),)
Willy Tarreau3dfadc72021-04-02 15:35:19 +0200636OPTIONS_OBJS += addons/promex/service-prometheus.o
Willy Tarreau92dc7862021-04-02 15:31:10 +0200637endif
638
David Carliera03fb142015-06-01 14:00:07 +0200639ifneq ($(USE_DEVICEATLAS),)
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200640# Use DEVICEATLAS_SRC and possibly DEVICEATLAS_INC and DEVICEATLAS_LIB to force path
Dragan Dosen93b38d92015-06-29 16:43:25 +0200641# to DeviceAtlas headers and libraries if needed.
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200642DEVICEATLAS_SRC =
643DEVICEATLAS_INC = $(DEVICEATLAS_SRC)
644DEVICEATLAS_LIB = $(DEVICEATLAS_SRC)
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100645ifeq ($(DEVICEATLAS_SRC),)
646OPTIONS_LDFLAGS += -lda
647else
David Carlier019dbd72021-02-16 11:37:45 +0000648ifeq ($(USE_PCRE),)
649ifeq ($(USE_PCRE2),)
650$(error the DeviceAtlas module needs the PCRE or the PCRE2 library in order to compile)
651endif
652endif
653ifneq ($(USE_PCRE2),)
654OPTIONS_CFLAGS += -DDA_REGEX_HDR=\"dac_pcre2.c\" -DDA_REGEX_TAG=2
655endif
David Carliera03fb142015-06-01 14:00:07 +0200656OPTIONS_OBJS += $(DEVICEATLAS_LIB)/json.o
657OPTIONS_OBJS += $(DEVICEATLAS_LIB)/dac.o
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100658endif
Willy Tarreauf8d9ec52021-04-02 16:19:39 +0200659OPTIONS_OBJS += addons/deviceatlas/da.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100660OPTIONS_CFLAGS += $(if $(DEVICEATLAS_INC),-I$(DEVICEATLAS_INC))
David Carliera03fb142015-06-01 14:00:07 +0200661endif
662
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100663ifneq ($(USE_51DEGREES),)
Willy Tarreauc7203c72015-06-01 11:12:35 +0200664# Use 51DEGREES_SRC and possibly 51DEGREES_INC and 51DEGREES_LIB to force path
665# to 51degrees headers and libraries if needed.
66651DEGREES_SRC =
66751DEGREES_INC = $(51DEGREES_SRC)
66851DEGREES_LIB = $(51DEGREES_SRC)
James Rosewell3670eb12015-09-18 17:24:29 +0100669OPTIONS_OBJS += $(51DEGREES_LIB)/../cityhash/city.o
Dragan Dosen93b38d92015-06-29 16:43:25 +0200670OPTIONS_OBJS += $(51DEGREES_LIB)/51Degrees.o
Willy Tarreau977209d2021-04-02 16:12:32 +0200671OPTIONS_OBJS += addons/51degrees/51d.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100672OPTIONS_CFLAGS += $(if $(51DEGREES_INC),-I$(51DEGREES_INC))
Ben51Degrees4ddf59d2019-02-05 13:24:00 +0000673ifeq ($(USE_THREAD),)
674OPTIONS_CFLAGS += -DFIFTYONEDEGREES_NO_THREADING
675else
676OPTIONS_OBJS += $(51DEGREES_LIB)/../threading.o
677endif
678
James Rosewell3670eb12015-09-18 17:24:29 +0100679OPTIONS_LDFLAGS += $(if $(51DEGREES_LIB),-L$(51DEGREES_LIB)) -lm
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100680endif
681
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200682ifneq ($(USE_WURFL),)
683# Use WURFL_SRC and possibly WURFL_INC and WURFL_LIB to force path
684# to WURFL headers and libraries if needed.
685WURFL_SRC =
686WURFL_INC = $(WURFL_SRC)
687WURFL_LIB = $(WURFL_SRC)
Willy Tarreau57610c62021-04-02 16:39:44 +0200688OPTIONS_OBJS += addons/wurfl/wurfl.o
Willy Tarreau14261982019-04-23 10:57:09 +0200689OPTIONS_CFLAGS += $(if $(WURFL_INC),-I$(WURFL_INC))
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200690ifneq ($(WURFL_DEBUG),)
691OPTIONS_CFLAGS += -DWURFL_DEBUG
692endif
693ifneq ($(WURFL_HEADER_WITH_DETAILS),)
694OPTIONS_CFLAGS += -DWURFL_HEADER_WITH_DETAILS
695endif
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200696OPTIONS_LDFLAGS += $(if $(WURFL_LIB),-L$(WURFL_LIB)) -lwurfl
697endif
698
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100699ifneq ($(USE_SYSTEMD),)
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100700OPTIONS_LDFLAGS += -lsystemd
701endif
702
Hiroaki Nakamura70351322013-01-13 15:00:42 +0900703ifneq ($(USE_PCRE)$(USE_STATIC_PCRE)$(USE_PCRE_JIT),)
David Carlierf2592b22016-11-21 21:25:58 +0000704ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
705$(error cannot compile both PCRE and PCRE2 support)
706endif
Willy Tarreau39793092013-02-13 12:39:06 +0100707# PCREDIR is used to automatically construct the PCRE_INC and PCRE_LIB paths,
708# by appending /include and /lib respectively. If your system does not use the
709# same sub-directories, simply force these variables instead of PCREDIR. It is
710# automatically detected but can be forced if required (for cross-compiling).
711# Forcing PCREDIR to an empty string will let the compiler use the default
712# locations.
713
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200714PCRE_CONFIG := pcre-config
715PCREDIR := $(shell $(PCRE_CONFIG) --prefix 2>/dev/null || echo /usr/local)
Willy Tarreau39793092013-02-13 12:39:06 +0100716ifneq ($(PCREDIR),)
717PCRE_INC := $(PCREDIR)/include
718PCRE_LIB := $(PCREDIR)/lib
Willy Tarreau79b34bf2006-12-22 15:28:43 +0100719endif
Willy Tarreau39793092013-02-13 12:39:06 +0100720
Christian Wiesec8203002008-11-20 14:47:04 +0100721ifeq ($(USE_STATIC_PCRE),)
Willy Tarreau39793092013-02-13 12:39:06 +0100722# dynamic PCRE
723OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
724OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -lpcreposix -lpcre
Willy Tarreau39793092013-02-13 12:39:06 +0100725else
726# static PCRE
727OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
728OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -Wl,-Bstatic -lpcreposix -lpcre -Wl,-Bdynamic
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100729endif
Willy Tarreau39793092013-02-13 12:39:06 +0100730endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100731
David Carlierf2592b22016-11-21 21:25:58 +0000732ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200733PCRE2_CONFIG := pcre2-config
734PCRE2DIR := $(shell $(PCRE2_CONFIG) --prefix 2>/dev/null || echo /usr/local)
David Carlierf2592b22016-11-21 21:25:58 +0000735ifneq ($(PCRE2DIR),)
736PCRE2_INC := $(PCRE2DIR)/include
737PCRE2_LIB := $(PCRE2DIR)/lib
738
739ifeq ($(PCRE2_WIDTH),)
740PCRE2_WIDTH = 8
741endif
742
743ifneq ($(PCRE2_WIDTH),8)
744ifneq ($(PCRE2_WIDTH),16)
745ifneq ($(PCRE2_WIDTH),32)
746$(error PCRE2_WIDTH needs to be set to either 8,16 or 32)
747endif
748endif
749endif
750
751
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200752PCRE2_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 +0000753
754ifeq ($(PCRE2_LDFLAGS),)
755$(error libpcre2-$(PCRE2_WIDTH) not found)
756else
757ifeq ($(PCRE2_WIDTH),8)
758PCRE2_LDFLAGS += -lpcre2-posix
759endif
760endif
761
762OPTIONS_CFLAGS += -DUSE_PCRE2 -DPCRE2_CODE_UNIT_WIDTH=$(PCRE2_WIDTH)
763OPTIONS_CFLAGS += $(if $(PCRE2_INC), -I$(PCRE2_INC))
764
765ifneq ($(USE_STATIC_PCRE2),)
766OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -Wl,-Bstatic -L$(PCRE2_LIB) $(PCRE2_LDFLAGS) -Wl,-Bdynamic
David Carlierf2592b22016-11-21 21:25:58 +0000767else
768OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -L$(PCRE2_LIB) $(PCRE2_LDFLAGS)
David Carlierf2592b22016-11-21 21:25:58 +0000769endif
770
David Carlierf2592b22016-11-21 21:25:58 +0000771endif
772endif
773
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100774#### Global compile options
775VERBOSE_CFLAGS = $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE)
Willy Tarreaufc80e302020-05-27 11:05:33 +0200776COPTS = -Iinclude
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200777
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100778COPTS += $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE) $(SILENT_DEFINE)
779COPTS += $(DEBUG) $(OPTIONS_CFLAGS) $(ADDINC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100780
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200781ifneq ($(VERSION)$(SUBVERS)$(EXTRAVERSION),)
782COPTS += -DCONFIG_HAPROXY_VERSION=\"$(VERSION)$(SUBVERS)$(EXTRAVERSION)\"
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100783endif
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100784
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100785ifneq ($(VERDATE),)
786COPTS += -DCONFIG_HAPROXY_DATE=\"$(VERDATE)\"
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100787endif
788
Willy Tarreau7de211c2012-05-25 23:53:16 +0200789ifneq ($(TRACE),)
790# if tracing is enabled, we want it to be as fast as possible
791TRACE_COPTS := $(filter-out -O0 -O1 -O2 -pg -finstrument-functions,$(COPTS)) -O3 -fomit-frame-pointer
792COPTS += -finstrument-functions
793endif
794
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100795ifneq ($(USE_NS),)
Willy Tarreau7520e4f2018-11-11 14:38:09 +0100796OPTIONS_OBJS += src/namespace.o
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100797endif
798
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100799ifneq ($(USE_OT),)
Willy Tarreaua63d1a02021-04-02 17:16:46 +0200800include addons/ot/Makefile
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100801endif
802
Willy Tarreau70c268b2021-11-14 15:28:38 +0100803ifneq ($(USE_LIBATOMIC),)
804 TARGET_LDFLAGS += -latomic
805endif
806
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100807#### Global link options
808# These options are added at the end of the "ld" command line. Use LDFLAGS to
809# add options at the beginning of the "ld" command line if needed.
810LDOPTS = $(TARGET_LDFLAGS) $(OPTIONS_LDFLAGS) $(ADDLIB)
willy tarreau0f7af912005-12-17 12:21:26 +0100811
Willy Tarreau16119652018-11-19 08:15:54 +0100812ifeq ($V,1)
813cmd_CC = $(CC)
814cmd_LD = $(LD)
815cmd_AR = $(AR)
816else
Willy Tarreau9e3093c2021-11-19 10:23:36 +0100817ifeq (3.81,$(firstword $(sort $(MAKE_VERSION) 3.81)))
818# 3.81 or above
819cmd_CC = $(info $ CC $@) $(Q)$(CC)
820cmd_LD = $(info $ LD $@) $(Q)$(LD)
821cmd_AR = $(info $ AR $@) $(Q)$(AR)
822else
823# 3.80 or older
Willy Tarreau16119652018-11-19 08:15:54 +0100824cmd_CC = $(Q)echo " CC $@";$(CC)
825cmd_LD = $(Q)echo " LD $@";$(LD)
826cmd_AR = $(Q)echo " AR $@";$(AR)
827endif
Willy Tarreau9e3093c2021-11-19 10:23:36 +0100828endif
Willy Tarreau16119652018-11-19 08:15:54 +0100829
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100830ifeq ($(TARGET),)
831all:
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100832 @echo "Building HAProxy without specifying a TARGET is not supported."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100833 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100834 @echo "Usage:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100835 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100836 @echo " $ make help # To print a full explanation."
837 @echo " $ make TARGET=xxx USE_<feature>=1 # To build HAProxy."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100838 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100839 @echo "The most commonly used targets are:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100840 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100841 @echo " linux-glibc - Modern Linux with glibc"
842 @echo " linux-musl - Modern Linux with musl"
843 @echo " freebsd - FreeBSD"
844 @echo " openbsd - OpenBSD"
845 @echo " netbsd - NetBSD"
846 @echo " osx - macOS"
847 @echo " solaris - Solaris"
848 @echo
849 @echo "Choose the target which matches your OS the most in order to"
850 @echo "gain the maximum performance out of it."
851 @echo
852 @echo "Common features you might want to include in your build are:"
853 @echo
854 @echo " USE_OPENSSL=1 - Support for TLS encrypted connections"
855 @echo " USE_ZLIB=1 - Support for HTTP response compression"
856 @echo " USE_PCRE=1 - Support for PCRE regular expressions"
857 @echo " USE_LUA=1 - Support for dynamic processing using Lua"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100858 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100859 @echo "Use 'make help' to print a full explanation of supported targets"
860 @echo "and features."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100861 @echo
862 @exit 1
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200863else
864ifneq ($(filter $(TARGET), linux linux22 linux24 linux24e linux26 linux2628),)
Willy Tarreau99e49e92019-06-14 16:44:49 +0200865all:
866 @echo
867 @echo "Target '$(TARGET)' was removed from HAProxy 2.0 due to being irrelevant and"
868 @echo "often wrong. Please use 'linux-glibc' instead or define your custom target"
869 @echo "by checking available options using 'make help TARGET=<your-target>'."
870 @echo
871 @exit 1
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100872else
Willy Tarreau888bda02021-04-02 13:59:17 +0200873all: haproxy dev/flags/flags $(EXTRA)
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100874endif
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200875endif
willy tarreau0f7af912005-12-17 12:21:26 +0100876
Willy Tarreau2404e372020-11-05 16:42:25 +0100877OBJS =
Willy Tarreau7de211c2012-05-25 23:53:16 +0200878
Willy Tarreauada5d092019-01-10 10:01:03 +0100879ifneq ($(EXTRA_OBJS),)
880OBJS += $(EXTRA_OBJS)
881endif
Marc-Antoine Perennoued9803e2013-02-12 10:53:53 +0100882
Willy Tarreaue5f59482021-11-19 11:22:25 +0100883OBJS += src/mux_h2.o src/mux_fcgi.o src/http_ana.o src/mux_h1.o \
884 src/tcpcheck.o src/stream.o src/stats.o src/server.o src/flt_spoe.o \
885 src/stick_table.o src/tools.o src/sample.o src/log.o src/peers.o \
886 src/resolvers.o src/backend.o src/cfgparse.o src/http_htx.o src/cli.o \
887 src/proxy.o src/pattern.o src/connection.o src/check.o \
888 src/cfgparse-listen.o src/cache.o src/haproxy.o src/http_act.o \
889 src/http_fetch.o src/stream_interface.o src/dns.o src/listener.o \
890 src/http_client.o src/vars.o src/tcp_rules.o src/debug.o src/sink.o \
891 src/server_state.o src/filters.o src/h2.o src/fcgi-app.o src/task.o \
892 src/payload.o src/h1_htx.o src/mjson.o src/h1.o src/map.o \
893 src/flt_http_comp.o src/cfgparse-global.o src/mux_pt.o src/htx.o \
894 src/flt_trace.o src/acl.o src/trace.o src/tcp_sample.o src/mqtt.o \
895 src/lb_chash.o src/mworker.o src/activity.o src/sock.o src/session.o \
896 src/queue.o src/tcp_act.o src/ring.o src/proto_tcp.o src/fd.o \
897 src/http_rules.o src/channel.o src/http.o src/extcheck.o \
898 src/compression.o src/thread.o src/frontend.o src/raw_sock.o \
899 src/pool.o src/http_conv.o src/uri_normalizer.o src/lb_fwrr.o \
900 src/xprt_handshake.o src/sha1.o src/mailers.o src/ebmbtree.o \
901 src/applet.o src/proto_sockpair.o src/lb_fwlc.o src/errors.o \
902 src/lb_fas.o src/action.o src/proto_uxst.o src/cfgcond.o \
903 src/protocol.o src/proto_udp.o src/lb_map.o src/hpack-dec.o src/fix.o \
904 src/ev_select.o src/arg.o src/sock_unix.o src/sock_inet.o \
905 src/signal.o src/proto_uxdg.o src/mworker-prog.o src/fcgi.o \
906 src/eb32sctree.o src/clock.o src/chunk.o src/cfgparse-tcp.o \
907 src/cfgdiag.o src/shctx.o src/lru.o src/eb64tree.o src/eb32tree.o \
908 src/cfgparse-unix.o src/regex.o src/hpack-tbl.o src/ebimtree.o \
909 src/base64.o src/uri_auth.o src/time.o src/ebsttree.o src/ebistree.o \
910 src/dynbuf.o src/auth.o src/wdt.o src/pipe.o src/http_acl.o \
911 src/hpack-huff.o src/hpack-enc.o src/dict.o src/init.o src/freq_ctr.o \
912 src/ebtree.o src/hash.o src/dgram.o src/version.o
Willy Tarreau2404e372020-11-05 16:42:25 +0100913
914ifneq ($(TRACE),)
915OBJS += src/calltrace.o
916endif
917
Willy Tarreaub26835d2016-05-30 13:39:32 +0200918# Used only for forced dependency checking. May be cleared during development.
Willy Tarreaufc80e302020-05-27 11:05:33 +0200919INCLUDES = $(wildcard include/*/*.h)
Willy Tarreau8225bb42016-05-30 15:16:10 +0200920DEP = $(INCLUDES) .build_opts
921
William Lallemandf1b60f72018-12-13 14:02:25 +0100922help:
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000923 @sed -ne "/^[^#]*$$/q;s/^# \{0,1\}\(.*\)/\1/;p" Makefile
924 @echo; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200925 if [ -n "$(TARGET)" ]; then \
Willy Tarreau5fb76032019-06-16 19:26:18 +0200926 if [ -n "$(set_target_defaults)" ]; then \
927 echo "Current TARGET: $(TARGET)"; \
928 else \
929 echo "Current TARGET: $(TARGET) (custom target)"; \
930 fi; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200931 else \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200932 echo "TARGET not set, you may pass 'TARGET=xxx' to set one among :";\
Brad Smith382001b2020-10-08 01:15:06 -0400933 echo " linux-glibc, linux-glibc-legacy, solaris, freebsd, dragonfly, netbsd,"; \
934 echo " osx, openbsd, aix51, aix52, aix72-gcc, cygwin, haiku, generic,"; \
935 echo " custom"; \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200936 fi
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000937 @echo;echo "Enabled features for TARGET '$(TARGET)' (disable with 'USE_xxx=') :"
938 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),$(opt),)); echo " $$*" | (fmt || cat) 2>/dev/null
939 @echo;echo "Disabled features for TARGET '$(TARGET)' (enable with 'USE_xxx=1') :"
940 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),,$(opt))); echo " $$*" | (fmt || cat) 2>/dev/null
William Lallemandf1b60f72018-12-13 14:02:25 +0100941
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100942# Used only to force a rebuild if some build options change, but we don't do
943# it for certain targets which take no build options
944ifneq (reg-tests, $(firstword $(MAKECMDGOALS)))
Tim Duesterhus81e948e2020-11-21 18:07:58 +0100945build_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 +0100946.build_opts: $(build_opts)
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100947else
948.build_opts:
949endif
Willy Tarreaub26835d2016-05-30 13:39:32 +0200950
Willy Tarreauff0e8a42020-05-27 10:43:24 +0200951haproxy: $(OPTIONS_OBJS) $(OBJS)
Willy Tarreau16119652018-11-19 08:15:54 +0100952 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
willy tarreau0f7af912005-12-17 12:21:26 +0100953
Willy Tarreaubaaee002006-06-26 02:48:02 +0200954objsize: haproxy
Willy Tarreaub42233a2018-11-19 07:44:42 +0100955 $(Q)objdump -t $^|grep ' g '|grep -F '.text'|awk '{print $$5 FS $$6}'|sort
Willy Tarreaubaaee002006-06-26 02:48:02 +0200956
Willy Tarreaub26835d2016-05-30 13:39:32 +0200957%.o: %.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100958 $(cmd_CC) $(COPTS) -c -o $@ $<
willy tarreau0f7af912005-12-17 12:21:26 +0100959
Willy Tarreaua9f16c62021-04-02 14:46:21 +0200960admin/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
961 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200962
Willy Tarreau6807c7f2021-08-11 13:54:52 +0200963admin/dyncookie/dyncookie: admin/dyncookie/dyncookie.o
964 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
965
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200966dev/flags/flags: dev/flags/flags.o
967 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200968
Willy Tarreau21ef8b92021-04-02 14:27:26 +0200969dev/hpack/%: dev/hpack/%.o
970 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
971
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200972dev/poll/poll:
973 $(Q)$(MAKE) -C dev/poll poll CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200974
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200975dev/tcploop/tcploop:
976 $(Q)$(MAKE) -C dev/tcploop tcploop CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200977
Willy Tarreau909b9d82019-01-04 18:20:32 +0100978# rebuild it every time
979.PHONY: src/version.c
980
Willy Tarreau9eebd8a2019-08-08 16:53:40 +0200981src/calltrace.o: src/calltrace.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100982 $(cmd_CC) $(TRACE_COPTS) -c -o $@ $<
Willy Tarreau7de211c2012-05-25 23:53:16 +0200983
Willy Tarreaub26835d2016-05-30 13:39:32 +0200984src/haproxy.o: src/haproxy.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100985 $(cmd_CC) $(COPTS) \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100986 -DBUILD_TARGET='"$(strip $(TARGET))"' \
Willy Tarreauef7341d2009-04-11 19:45:50 +0200987 -DBUILD_ARCH='"$(strip $(ARCH))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100988 -DBUILD_CPU='"$(strip $(CPU))"' \
989 -DBUILD_CC='"$(strip $(CC))"' \
990 -DBUILD_CFLAGS='"$(strip $(VERBOSE_CFLAGS))"' \
991 -DBUILD_OPTIONS='"$(strip $(BUILD_OPTIONS))"' \
Tim Duesterhusc8d19702020-11-21 18:07:59 +0100992 -DBUILD_DEBUG='"$(strip $(DEBUG))"' \
Willy Tarreau7728ed32019-03-27 13:20:08 +0100993 -DBUILD_FEATURES='"$(strip $(BUILD_FEATURES))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100994 -c -o $@ $<
Willy Tarreau7b066db2007-12-02 11:28:59 +0100995
Christian Wiese19b50292008-03-12 15:57:54 +0200996install-man:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100997 $(Q)install -v -d "$(DESTDIR)$(MANDIR)"/man1
998 $(Q)install -v -m 644 doc/haproxy.1 "$(DESTDIR)$(MANDIR)"/man1
Christian Wiese19b50292008-03-12 15:57:54 +0200999
Vincent Bernat5c5147f2015-10-13 22:20:55 +02001000EXCLUDE_DOCUMENTATION = lgpl gpl coding-style
1001DOCUMENTATION = $(filter-out $(EXCLUDE_DOCUMENTATION),$(patsubst doc/%.txt,%,$(wildcard doc/*.txt)))
1002
Christian Wiesebf34eb42008-03-12 17:24:49 +02001003install-doc:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001004 $(Q)install -v -d "$(DESTDIR)$(DOCDIR)"
1005 $(Q)for x in $(DOCUMENTATION); do \
1006 install -v -m 644 doc/$$x.txt "$(DESTDIR)$(DOCDIR)" ; \
Christian Wiesebf34eb42008-03-12 17:24:49 +02001007 done
1008
Willy Tarreau13d67bb2016-06-24 18:30:22 +02001009install-bin:
Willy Tarreaub42233a2018-11-19 07:44:42 +01001010 $(Q)for i in haproxy $(EXTRA); do \
Willy Tarreau13d67bb2016-06-24 18:30:22 +02001011 if ! [ -e "$$i" ]; then \
1012 echo "Please run 'make' before 'make install'."; \
1013 exit 1; \
1014 fi; \
1015 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001016 $(Q)install -v -d "$(DESTDIR)$(SBINDIR)"
1017 $(Q)install -v haproxy $(EXTRA) "$(DESTDIR)$(SBINDIR)"
Christian Wiesea184aa22008-03-12 15:25:35 +02001018
Christian Wiesedb5238d2008-03-12 18:28:13 +02001019install: install-bin install-man install-doc
Christian Wiese4cf5d572008-03-12 16:21:05 +02001020
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001021uninstall:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001022 $(Q)rm -f "$(DESTDIR)$(MANDIR)"/man1/haproxy.1
1023 $(Q)for x in $(DOCUMENTATION); do \
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001024 rm -f "$(DESTDIR)$(DOCDIR)"/$$x.txt ; \
1025 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001026 $(Q)-rmdir "$(DESTDIR)$(DOCDIR)"
1027 $(Q)rm -f "$(DESTDIR)$(SBINDIR)"/haproxy
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001028
willy tarreau0f7af912005-12-17 12:21:26 +01001029clean:
Willy Tarreauff0e8a42020-05-27 10:43:24 +02001030 $(Q)rm -f *.[oas] src/*.[oas] haproxy test .build_opts .build_opts.new
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001031 $(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 +02001032 $(Q)rm -f haproxy-$(VERSION).tar.gz haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1033 $(Q)rm -f haproxy-$(VERSION) haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) nohup.out gmon.out
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001034 $(Q)rm -f addons/promex/*.[oas]
Willy Tarreau977209d2021-04-02 16:12:32 +02001035 $(Q)rm -f addons/51degrees/*.[oas] addons/51degrees/dummy/*.[oas] addons/51degrees/dummy/*/*.[oas]
Willy Tarreauf8d9ec52021-04-02 16:19:39 +02001036 $(Q)rm -f addons/deviceatlas/*.[oas] addons/deviceatlas/dummy/*.[oas]
Willy Tarreaua63d1a02021-04-02 17:16:46 +02001037 $(Q)rm -f addons/ot/src/*.[oas]
Willy Tarreau57610c62021-04-02 16:39:44 +02001038 $(Q)rm -f addons/wurfl/*.[oas] addons/wurfl/dummy/*.[oas]
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001039 $(Q)rm -f admin/*/*.[oas] admin/*/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001040 $(Q)rm -f admin/iprange/iprange admin/iprange/ip6range admin/halog/halog
Willy Tarreau6807c7f2021-08-11 13:54:52 +02001041 $(Q)rm -f admin/dyncookie/dyncookie
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001042 $(Q)rm -f dev/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001043 $(Q)rm -f dev/flags/flags dev/poll/poll dev/tcploop/tcploop
Willy Tarreau21ef8b92021-04-02 14:27:26 +02001044 $(Q)rm -f dev/hpack/decode dev/hpack/gen-enc dev/hpack/gen-rht
willy tarreauefae1842005-12-17 12:51:03 +01001045
Willy Tarreauebe0af42009-10-10 22:20:44 +02001046tags:
Willy Tarreau6db82662018-11-19 08:14:40 +01001047 $(Q)find src include \( -name '*.c' -o -name '*.h' \) -print0 | \
Willy Tarreauebe0af42009-10-10 22:20:44 +02001048 xargs -0 etags --declarations --members
1049
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001050cscope:
Willy Tarreau6db82662018-11-19 08:14:40 +01001051 $(Q)find src include -name "*.[ch]" -print | cscope -q -b -i -
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001052
willy tarreaue114bf92006-03-19 21:30:14 +01001053tar: clean
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001054 $(Q)ln -s . haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
1055 $(Q)tar --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/.git \
1056 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) \
1057 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz \
1058 -cf - haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/* | gzip -c9 >haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1059 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1060 $(Q)rm -f haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
willy tarreaucee272f2006-03-19 21:16:26 +01001061
Willy Tarreau05ed29c2012-12-20 15:00:44 +01001062git-tar:
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001063 $(Q)git archive --format=tar --prefix="haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/" HEAD | gzip -9 > haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1064 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
Willy Tarreauec692562007-09-09 23:31:11 +02001065
1066version:
1067 @echo "VERSION: $(VERSION)"
1068 @echo "SUBVERS: $(SUBVERS)"
1069 @echo "VERDATE: $(VERDATE)"
1070
1071# never use this one if you don't know what it is used for.
1072update-version:
1073 @echo "Ready to update the following versions :"
1074 @echo "VERSION: $(VERSION)"
1075 @echo "SUBVERS: $(SUBVERS)"
1076 @echo "VERDATE: $(VERDATE)"
1077 @echo "Press [ENTER] to continue or Ctrl-C to abort now.";read
1078 echo "$(VERSION)" > VERSION
1079 echo "$(SUBVERS)" > SUBVERS
1080 echo "$(VERDATE)" > VERDATE
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001081
Willy Tarreaua8b12c62018-10-03 09:40:22 +02001082# just display the build options
1083opts:
1084 @echo -n 'Using: '
1085 @echo -n 'TARGET="$(strip $(TARGET))" '
1086 @echo -n 'ARCH="$(strip $(ARCH))" '
1087 @echo -n 'CPU="$(strip $(CPU))" '
1088 @echo -n 'CC="$(strip $(CC))" '
1089 @echo -n 'ARCH_FLAGS="$(strip $(ARCH_FLAGS))" '
1090 @echo -n 'CPU_CFLAGS="$(strip $(CPU_CFLAGS))" '
1091 @echo -n 'DEBUG_CFLAGS="$(strip $(DEBUG_CFLAGS))" '
1092 @echo "$(strip $(BUILD_OPTIONS))"
1093 @echo 'COPTS="$(strip $(COPTS))"'
1094 @echo 'LDFLAGS="$(strip $(LDFLAGS))"'
1095 @echo 'LDOPTS="$(strip $(LDOPTS))"'
1096 @echo 'OPTIONS_OBJS="$(strip $(OPTIONS_OBJS))"'
1097 @echo 'OBJS="$(strip $(OBJS))"'
1098
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001099ifeq (reg-tests, $(firstword $(MAKECMDGOALS)))
1100 REGTEST_ARGS := $(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))
1101 $(eval $(REGTEST_ARGS):;@true)
1102endif
1103
Frédéric Lécaille99316342018-08-22 10:41:33 +02001104# Target to run the regression testing script files.
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001105reg-tests:
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001106 $(Q)$(REG_TEST_SCRIPT) --type "$(REGTESTS_TYPES)" $(REGTEST_ARGS) $(REG_TEST_FILES)
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001107.PHONY: $(REGTEST_ARGS)
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001108
1109reg-tests-help:
1110 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001111 @echo "To launch the reg tests for haproxy, first export to your environment "
1112 @echo "VTEST_PROGRAM variable to point to your vtest program:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001113 @echo " $$ export VTEST_PROGRAM=/opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001114 @echo "or"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001115 @echo " $$ setenv VTEST_PROGRAM /opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001116 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001117 @echo "The same thing may be done to set your haproxy program with HAPROXY_PROGRAM "
1118 @echo "but with ./haproxy as default value."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001119 @echo
1120 @echo "To run all the tests:"
1121 @echo " $$ make reg-tests"
1122 @echo
1123 @echo "You can also set the programs to be used on the command line:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001124 @echo " $$ VTEST_PROGRAM=<...> HAPROXY_PROGRAM=<...> make reg-tests"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001125 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001126 @echo "To run tests with specific types:"
1127 @echo " $$ REGTESTS_TYPES=slow,default make reg-tests"
1128 @echo
William Lallemandc1ddcaf2021-02-05 11:27:54 +01001129 @echo "with 'default,bug,devel,slow' as default value for REGTESTS_TYPES variable."
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001130 @echo
1131 @echo "About the reg test types:"
1132 @echo " any : all the tests without distinction (this is the default"
1133 @echo " value of REGTESTS_TYPES."
1134 @echo " default : dedicated to pure haproxy compliance tests."
1135 @echo " slow : scripts which take non negligible time to run."
1136 @echo " bug : scripts in relation with bugs they help to reproduce."
1137 @echo " broken : scripts triggering known broken behaviors for which"
1138 @echo " there is still no fix."
1139 @echo " experimental: for scripts which are experimental, typically used to"
1140 @echo " develop new scripts."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001141 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001142 @echo "Note that 'reg-tests' target run '"$(REG_TEST_SCRIPT)"' script"
1143 @echo "(see --help option of this script for more information)."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001144
1145.PHONY: reg-tests reg-tests-help