blob: 566bdb26a3e779cd5390c7d1166955cda711d423 [file] [log] [blame]
Willy Tarreau9f2b7302008-01-02 20:48:34 +01001# This GNU Makefile supports different OS and CPU combinations.
2#
willy tarreaueedaa9f2005-12-17 14:08:03 +01003# You should use it this way :
Willy Tarreau50b1aae2019-06-14 15:52:01 +02004# [g]make TARGET=os [ARCH=arch] [CPU=cpu] USE_xxx=1 ...
5#
6# When in doubt, invoke help, possibly with a known target :
7# [g]make help
Willy Tarreau61cf0dc2019-06-14 16:32:09 +02008# [g]make help TARGET=linux-glibc
Willy Tarreauf2ef8c52007-07-11 09:19:31 +02009#
Willy Tarreau16119652018-11-19 08:15:54 +010010# By default the detailed commands are hidden for a cleaner output, but you may
11# see them by appending "V=1" to the make command.
12#
Willy Tarreau05fd82d2019-03-27 10:57:49 +010013# Valid USE_* options are enumerated in the "use_opts" variable and are listed
14# below. Most of them are automatically set by the TARGET, others have to be
15# explicitly specified :
Willy Tarreau9f2b7302008-01-02 20:48:34 +010016# USE_EPOLL : enable epoll() on Linux 2.6. Automatic.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010017# USE_KQUEUE : enable kqueue() on BSD. Automatic.
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +000018# USE_EVPORTS : enable event ports on SunOS systems. Automatic.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010019# USE_NETFILTER : enable netfilter on Linux. Automatic.
20# USE_PCRE : enable use of libpcre for regex. Recommended.
Willy Tarreau91418062013-04-04 23:05:32 +020021# USE_PCRE_JIT : enable JIT for faster regex on libpcre >= 8.32
David Carlierf2592b22016-11-21 21:25:58 +000022# USE_PCRE2 : enable use of libpcre2 for regex.
23# USE_PCRE2_JIT : enable JIT for faster regex on libpcre2
Willy Tarreau9f2b7302008-01-02 20:48:34 +010024# USE_POLL : enable poll(). Automatic.
Emeric Brun9faf0712012-09-25 11:11:16 +020025# USE_PRIVATE_CACHE : disable shared memory cache of ssl sessions.
Christopher Fauleta1ae7e82017-10-25 17:55:27 +020026# USE_THREAD : enable threads support.
Emeric Bruncd1a5262014-05-07 23:11:42 +020027# USE_PTHREAD_PSHARED : enable pthread process shared mutex on sslcache.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010028# USE_STATIC_PCRE : enable static libpcre. Recommended.
David Carlierf2592b22016-11-21 21:25:58 +000029# USE_STATIC_PCRE2 : enable static libpcre2.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010030# USE_TPROXY : enable transparent proxy. Automatic.
Willy Tarreaue0c623d2012-06-04 00:42:09 +020031# USE_LINUX_TPROXY : enable full transparent proxy. Automatic.
32# USE_LINUX_SPLICE : enable kernel 2.6 splicing. Automatic.
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -070033# USE_LIBCRYPT : enable encrypted passwords using -lcrypt
Willy Tarreau890a33e2010-03-04 19:10:14 +010034# USE_CRYPT_H : set it if your system requires including crypt.h
Willy Tarreau64bc40b2011-03-23 20:00:53 +010035# USE_GETADDRINFO : use getaddrinfo() to resolve IPv6 host names.
Emeric Brun7444f012012-05-18 15:48:30 +020036# USE_OPENSSL : enable use of OpenSSL. Recommended, but see below.
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +010037# USE_LUA : enable Lua support.
Emeric Brun3e541d12012-09-03 11:14:36 +020038# USE_FUTEX : enable use of futex on kernel 2.6. Automatic.
Willy Tarreau1bc4aab2012-10-08 20:11:03 +020039# USE_ACCEPT4 : enable use of accept4() on linux. Automatic.
Brad Smith5018aac2020-09-30 01:04:48 -040040# USE_CLOSEFROM : enable use of closefrom() on *bsd, solaris. Automatic.
Willy Tarreau636848a2019-04-15 19:38:50 +020041# USE_PRCTL : enable use of prctl(). Automatic.
devnexen@gmail.com078062b2021-08-21 09:13:10 +010042# USE_PROCCTL : enable use of procctl(). Automatic.
Willy Tarreau12840be2021-04-22 14:14:22 +020043# USE_ZLIB : enable zlib library support and disable SLZ
44# USE_SLZ : enable slz library instead of zlib (default=enabled)
Willy Tarreaufc6c0322012-11-16 16:12:27 +010045# USE_CPU_AFFINITY : enable pinning processes to CPU on Linux. Automatic.
Lukas Tribus0999f762013-04-02 16:43:24 +020046# USE_TFO : enable TCP fast open. Supported on Linux >= 3.7.
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +010047# USE_NS : enable network namespace support. Supported on Linux >= 2.6.24.
Willy Tarreau71b99ef2015-03-17 14:33:22 +010048# USE_DL : enable it if your system requires -ldl. Automatic on Linux.
Willy Tarreau58e90cb2018-10-18 16:28:54 +020049# USE_RT : enable it if your system requires -lrt. Automatic on Linux.
Willy Tarreauf5b4e062020-03-03 15:40:23 +010050# USE_BACKTRACE : enable backtrace(). Automatic on Linux.
Willy Tarreau92dc7862021-04-02 15:31:10 +020051# USE_PROMEX : enable the Prometheus exporter
David Carliera03fb142015-06-01 14:00:07 +020052# USE_DEVICEATLAS : enable DeviceAtlas api.
Dragan Dosen93b38d92015-06-29 16:43:25 +020053# USE_51DEGREES : enable third party device detection library from 51Degrees
Willy Tarreaub3cc9f22019-04-19 16:03:32 +020054# USE_WURFL : enable WURFL detection library from Scientiamobile
Tim Duesterhusd6942c82017-11-20 15:58:35 +010055# USE_SYSTEMD : enable sd_notify() support.
Willy Tarreau7b5654f2019-03-29 21:30:17 +010056# USE_OBSOLETE_LINKER : use when the linker fails to emit __start_init/__stop_init
Willy Tarreauc7091d82019-05-17 10:08:49 +020057# USE_THREAD_DUMP : use the more advanced thread state dump system. Automatic.
Miroslav Zagorac70230c62020-12-09 16:54:31 +010058# USE_OT : enable the OpenTracing filter
Willy Tarreauf6818d62021-05-05 18:17:39 +020059# USE_MEMORY_PROFILING : enable the memory profiler. Linux-glibc only.
Willy Tarreauf2ef8c52007-07-11 09:19:31 +020060#
Willy Tarreau9f2b7302008-01-02 20:48:34 +010061# Options can be forced by specifying "USE_xxx=1" or can be disabled by using
Willy Tarreau50b1aae2019-06-14 15:52:01 +020062# "USE_xxx=" (empty string). The list of enabled and disabled options for a
63# given TARGET is enumerated at the end of "make help".
Willy Tarreau9f2b7302008-01-02 20:48:34 +010064#
65# Variables useful for packagers :
Brad Smith94636432020-09-13 02:53:06 -040066# CC is set to "cc" by default and is used for compilation only.
67# LD is set to "cc" by default and is used for linking only.
Willy Tarreauef7341d2009-04-11 19:45:50 +020068# ARCH may be useful to force build of 32-bit binary on 64-bit systems
Willy Tarreau9f2b7302008-01-02 20:48:34 +010069# CFLAGS is automatically set for the specified CPU and may be overridden.
70# LDFLAGS is automatically set to -g and may be overridden.
Willy Tarreaub26835d2016-05-30 13:39:32 +020071# DEP may be cleared to ignore changes to include files during development
Willy Tarreau9f2b7302008-01-02 20:48:34 +010072# SMALL_OPTS may be used to specify some options to shrink memory usage.
73# DEBUG may be used to set some internal debugging options.
Willy Tarreau23cd43e2018-10-22 06:22:46 +020074# ERR may be set to non-empty to pass -Werror to the compiler
Willy Tarreau9f2b7302008-01-02 20:48:34 +010075# ADDINC may be used to complete the include path in the form -Ipath.
76# ADDLIB may be used to complete the library list in the form -Lpath -llib.
77# DEFINE may be used to specify any additional define, which will be reported
78# by "haproxy -vv" in CFLAGS.
79# SILENT_DEFINE may be used to specify other defines which will not be
80# reported by "haproxy -vv".
William Lallemanda6cfa902017-06-01 17:38:58 +020081# EXTRA is used to force building or not building some extra tools.
Christian Wiesea184aa22008-03-12 15:25:35 +020082# DESTDIR is not set by default and is used for installation only.
83# It might be useful to set DESTDIR if you want to install haproxy
84# in a sandbox.
85# PREFIX is set to "/usr/local" by default and is used for installation only.
86# SBINDIR is set to "$(PREFIX)/sbin" by default and is used for installation
87# only.
Christian Wiese19b50292008-03-12 15:57:54 +020088# MANDIR is set to "$(PREFIX)/share/man" by default and is used for
89# installation only.
Christian Wiesebf34eb42008-03-12 17:24:49 +020090# DOCDIR is set to "$(PREFIX)/doc/haproxy" by default and is used for
91# installation only.
Tim Duesterhus541fe1e2020-01-12 13:55:41 +010092# HLUA_PREPEND_PATH may be used to prepend a folder to Lua's default package.path.
93# HLUA_PREPEND_CPATH may be used to prepend a folder to Lua's default package.cpath.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010094#
95# Other variables :
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +020096# PCRE_CONFIG : force the binary path to get pcre config (by default
97# pcre-config)
Willy Tarreau9f2b7302008-01-02 20:48:34 +010098# PCREDIR : force the path to libpcre.
Willy Tarreau39793092013-02-13 12:39:06 +010099# PCRE_LIB : force the lib path to libpcre (defaults to $PCREDIR/lib).
100# PCRE_INC : force the include path to libpcre ($PCREDIR/inc)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200101# PCRE2_CONFIG : force the binary path to get pcre2 config (by default
102# pcre2-config)
Willy Tarreau9a059452013-09-17 15:26:39 +0200103# SSL_LIB : force the lib path to libssl/libcrypto
104# SSL_INC : force the include path to libssl/libcrypto
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100105# LUA_LIB : force the lib path to lua
106# LUA_INC : force the include path to lua
Cyril Bontéc21adb52015-03-03 23:13:03 +0100107# LUA_LIB_NAME : force the lib name (or automatically evaluated, by order of
Thierry FOURNIERf90838b2015-03-06 13:48:32 +0100108# priority : lua5.3, lua53, lua).
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100109# OT_DEBUG : compile the OpenTracing filter in debug mode
110# OT_INC : force the include path to libopentracing-c-wrapper
111# OT_LIB : force the lib path to libopentracing-c-wrapper
112# OT_RUNPATH : add RUNPATH for libopentracing-c-wrapper to haproxy executable
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100113# IGNOREGIT : ignore GIT commit versions if set.
114# VERSION : force haproxy version reporting.
115# SUBVERS : add a sub-version (eg: platform, model, ...).
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200116# EXTRAVERSION : local version string to append (e.g. build number etc)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100117# VERDATE : force haproxy's release date.
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200118# VTEST_PROGRAM : location of the vtest program to run reg-tests.
Ilya Shipitsin4a034f22020-09-12 11:24:48 +0500119# DEBUG_USE_ABORT: use abort() for program termination, see include/haproxy/bug.h for details
Willy Tarreau4f60f162007-04-08 16:39:58 +0200120
Willy Tarreaub42233a2018-11-19 07:44:42 +0100121# verbosity: pass V=1 for verbose shell invocation
122V = 0
123Q = @
124ifeq ($V,1)
125Q=
126endif
127
Christopher Faulet16150642021-04-14 14:02:56 +0200128# WARNING: Do not change cc-opt, cc-opt-alt or cc-warning without checking if
129# clang bug #49364 is fixed. stderr is redirected to /dev/null on
130# purpose, to work around a clang 11 bug that crashes if stderr is
131# redirected to stdin.
132#
Willy Tarreaud3a7f402017-09-13 16:54:28 +0200133# Function used to detect support of a given option by the compiler.
134# Usage: CFLAGS += $(call cc-opt,option). Eg: $(call cc-opt,-fwrapv)
135# Note: ensure the referencing variable is assigned using ":=" and not "=" to
136# call it only once.
Christopher Faulet16150642021-04-14 14:02:56 +0200137cc-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 +0200138
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200139# same but emits $2 if $1 is not supported
Christopher Faulet16150642021-04-14 14:02:56 +0200140cc-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 +0200141
Willy Tarreaub7801662017-09-14 19:05:45 +0200142# Disable a warning when supported by the compiler. Don't put spaces around the
143# warning! And don't use cc-opt which doesn't always report an error until
144# another one is also returned.
145# Usage: CFLAGS += $(call cc-nowarn,warning). Eg: $(call cc-opt,format-truncation)
Christopher Faulet16150642021-04-14 14:02:56 +0200146cc-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 +0200147
Christian Wiesea184aa22008-03-12 15:25:35 +0200148#### Installation options.
149DESTDIR =
150PREFIX = /usr/local
151SBINDIR = $(PREFIX)/sbin
Jeremy Hinegardneref3b4032008-11-15 17:29:03 -0700152MANDIR = $(PREFIX)/share/man
Christian Wiesebf34eb42008-03-12 17:24:49 +0200153DOCDIR = $(PREFIX)/doc/haproxy
Willy Tarreau4f60f162007-04-08 16:39:58 +0200154
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100155#### TARGET system
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500156# Use TARGET=<target_name> to optimize for a specific target OS among the
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100157# following list (use the default "generic" if uncertain) :
Brad Smith382001b2020-10-08 01:15:06 -0400158# linux-glibc, linux-glibc-legacy, linux-musl, solaris, freebsd, dragonfly,
159# openbsd, netbsd, cygwin, haiku, aix51, aix52, aix72-gcc, osx, generic,
160# custom
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100161TARGET =
Willy Tarreau4f60f162007-04-08 16:39:58 +0200162
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100163#### TARGET CPU
164# Use CPU=<cpu_name> to optimize for a particular CPU, among the following
165# list :
Willy Tarreau40a871f2021-05-12 09:47:30 +0200166# generic, native, i586, i686, ultrasparc, power8, power9, custom,
167# a53, a72, armv81, armv8-auto
willy tarreaueedaa9f2005-12-17 14:08:03 +0100168CPU = generic
willy tarreau036e1ce2005-12-17 13:46:33 +0100169
Willy Tarreauef7341d2009-04-11 19:45:50 +0200170#### Architecture, used when not building for native architecture
171# Use ARCH=<arch_name> to force build for a specific architecture. Known
172# architectures will lead to "-m32" or "-m64" being added to CFLAGS and
173# LDFLAGS. This can be required to build 32-bit binaries on 64-bit targets.
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100174# Currently, only 32, 64, x86_64, i386, i486, i586 and i686 are understood.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200175ARCH =
176
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100177#### Toolchain options.
Brad Smith94636432020-09-13 02:53:06 -0400178CC = cc
Christian Wiesef6308302008-03-17 18:23:12 +0100179LD = $(CC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100180
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100181#### Debug flags (typically "-g").
182# Those flags only feed CFLAGS so it is not mandatory to use this form.
183DEBUG_CFLAGS = -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100184
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200185#### Add -Werror when set to non-empty
186ERR =
187
Willy Tarreaudb863332018-11-23 08:29:15 +0100188#### May be used to force running a specific set of reg-tests
189REG_TEST_FILES =
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +0100190REG_TEST_SCRIPT=./scripts/run-regtests.sh
Willy Tarreaudb863332018-11-23 08:29:15 +0100191
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100192#### Compiler-specific flags that may be used to disable some negative over-
Willy Tarreaud1c847a2020-02-25 10:10:47 +0100193# optimization or to silence some warnings.
Olivier Houchard73bdb322017-04-19 11:34:10 +0200194# We rely on signed integer wraparound on overflow, however clang think it
195# can do whatever it wants since it's an undefined behavior, so use -fwrapv
196# to be sure we get the intended behavior.
Willy Tarreau4b61e692020-03-10 09:37:08 +0100197SPEC_CFLAGS := -Wall -Wextra -Wdeclaration-after-statement
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200198SPEC_CFLAGS += $(call cc-opt-alt,-fwrapv,$(call cc-opt,-fno-strict-overflow))
Willy Tarreaub7801662017-09-14 19:05:45 +0200199SPEC_CFLAGS += $(call cc-nowarn,address-of-packed-member)
Willy Tarreaueff9a9e2017-10-27 11:06:11 +0200200SPEC_CFLAGS += $(call cc-nowarn,unused-label)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200201SPEC_CFLAGS += $(call cc-nowarn,sign-compare)
202SPEC_CFLAGS += $(call cc-nowarn,unused-parameter)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200203SPEC_CFLAGS += $(call cc-nowarn,clobbered)
204SPEC_CFLAGS += $(call cc-nowarn,missing-field-initializers)
Olivier Houchard73bce432018-11-27 14:47:58 +0100205SPEC_CFLAGS += $(call cc-nowarn,cast-function-type)
Willy Tarreauc77c2d42019-09-24 09:43:34 +0200206SPEC_CFLAGS += $(call cc-nowarn,string-plus-int)
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,
234# DEBUG_MEM_STATS, DEBUG_DONT_SHARE_POOLS, DEBUG_NO_LOCKLESS_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 Lallemand60c3b8e2021-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 Tarreauf5b4e062020-03-03 15:40:23 +0100312 USE_PRIVATE_CACHE USE_THREAD USE_PTHREAD_PSHARED 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 Tarreau05fd82d2019-03-27 10:57:49 +0100315 USE_GETADDRINFO USE_OPENSSL USE_LUA USE_FUTEX 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.com078062b2021-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
Christopher Fauleta1ae7e82017-10-25 17:55:27 +0200339# Always enable threads support by default and let the Makefile detect if
340# HAProxy can be compiled with threads or not.
341
Willy Tarreau39f19922019-03-27 11:44:19 +0100342# generic system target has nothing specific
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100343ifeq ($(TARGET),generic)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100344 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY)
Willy Tarreau39f19922019-03-27 11:44:19 +0100345endif
346
347# Haiku
Jerome Duval38932c32015-10-19 23:01:16 +0000348ifeq ($(TARGET),haiku)
Jerome Duval38932c32015-10-19 23:01:16 +0000349 TARGET_LDFLAGS = -lnetwork
David Carlierb2f06cc2021-06-19 14:42:43 +0000350 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Willy Tarreau39f19922019-03-27 11:44:19 +0100351endif
352
Willy Tarreau61cf0dc2019-06-14 16:32:09 +0200353# For linux >= 2.6.28 and glibc
354ifeq ($(TARGET),linux-glibc)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100355 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100356 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
357 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
Willy Tarreau364d6f52019-06-14 18:33:56 +0200358 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100359 USE_GETADDRINFO USE_BACKTRACE)
Willy Tarreau48e86032020-03-18 08:20:45 +0100360ifneq ($(shell echo __arm__/__aarch64__ | $(CC) -E -xc - | grep '^[^\#]'),__arm__/__aarch64__)
David Carlierd93e6ec2020-03-15 10:30:51 +0000361 TARGET_LDFLAGS=-latomic
362endif
Willy Tarreau39f19922019-03-27 11:44:19 +0100363endif
364
Lukas Tribuscc1eb162019-09-01 16:48:36 +0200365# For linux >= 2.6.28, glibc without new features
366ifeq ($(TARGET),linux-glibc-legacy)
367 set_target_defaults = $(call default_opts, \
368 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
369 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
370 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_GETADDRINFO)
371endif
372
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200373# For linux >= 2.6.28 and musl
374ifeq ($(TARGET),linux-musl)
375 set_target_defaults = $(call default_opts, \
376 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
377 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
378 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
379 USE_GETADDRINFO)
380ifneq ($(shell echo __arm__/__aarch64__ | $(CC) -E -xc - | grep '^[^\#]'),__arm__/__aarch64__)
381 TARGET_LDFLAGS=-latomic
382endif
383endif
384
Brad Smith7c503bb2020-09-30 15:46:16 -0400385# Solaris 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100386ifeq ($(TARGET),solaris)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100387 set_target_defaults = $(call default_opts, \
Emmanuel Hocdet7093c192019-05-21 09:12:03 +0000388 USE_POLL USE_TPROXY USE_LIBCRYPT USE_CRYPT_H USE_GETADDRINFO USE_THREAD \
Brad Smith7c503bb2020-09-30 15:46:16 -0400389 USE_RT USE_OBSOLETE_LINKER USE_EVPORTS USE_CLOSEFROM)
Emmanuel Hocdet3c0edfa2019-05-17 15:32:21 +0000390 TARGET_CFLAGS = -DFD_SETSIZE=65536 -D_REENTRANT -D_XOPEN_SOURCE=500 -D__EXTENSIONS__
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100391 TARGET_LDFLAGS = -lnsl -lsocket
Willy Tarreau39f19922019-03-27 11:44:19 +0100392endif
393
Brad Smith9d85eb02020-09-15 03:10:04 -0400394# FreeBSD 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100395ifeq ($(TARGET),freebsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100396 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100397 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
devnexen@gmail.com078062b2021-08-21 09:13:10 +0100398 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO USE_PROCCTL)
Willy Tarreau39f19922019-03-27 11:44:19 +0100399endif
400
Brad Smith382001b2020-10-08 01:15:06 -0400401# DragonFlyBSD 4.3 and above
402ifeq ($(TARGET),dragonfly)
403 set_target_defaults = $(call default_opts, \
404 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
405 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO)
406endif
407
Willy Tarreau39f19922019-03-27 11:44:19 +0100408# Mac OS/X
Willy Tarreau8624cab2013-04-02 08:17:43 +0200409ifeq ($(TARGET),osx)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100410 set_target_defaults = $(call default_opts, \
Brad Smithad5afba2020-10-09 19:26:23 -0400411 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
412 USE_GETADDRINFO)
Willy Tarreaub684e7a2018-03-05 15:37:04 +0100413 EXPORT_SYMBOL = -export_dynamic
Willy Tarreau39f19922019-03-27 11:44:19 +0100414endif
415
Brad Smith90c9d782020-09-26 23:05:25 -0400416# OpenBSD 6.3 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100417ifeq ($(TARGET),openbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100418 set_target_defaults = $(call default_opts, \
Matthieu Guegan496374e2020-11-20 10:50:39 +0100419 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_KQUEUE USE_ACCEPT4 \
420 USE_CLOSEFROM USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100421endif
422
Brad Smith0fdfe412020-10-08 16:24:52 -0400423# NetBSD 8 and above
David Carlierb5714da2015-07-02 06:58:22 +0000424ifeq ($(TARGET),netbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100425 set_target_defaults = $(call default_opts, \
Brad Smith0fdfe412020-10-08 16:24:52 -0400426 USE_POLL USE_TPROXY USE_THREAD USE_KQUEUE USE_ACCEPT4 USE_CLOSEFROM \
427 USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100428endif
429
430# AIX 5.1 only
Willy Tarreau50abe302014-04-02 20:44:43 +0200431ifeq ($(TARGET),aix51)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100432 set_target_defaults = $(call default_opts, \
Willy Tarreau13d9b022019-03-29 18:56:54 +0100433 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER USE_PRIVATE_CACHE)
Willy Tarreau0aed6ac2019-03-29 18:56:00 +0100434 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 +0200435 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100436endif
437
Christian Lachnerc1322302020-02-10 10:29:13 +0100438# AIX 5.2
Willy Tarreau7dec9652012-06-06 16:15:03 +0200439ifeq ($(TARGET),aix52)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100440 set_target_defaults = $(call default_opts, \
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100441 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER)
Willy Tarreau7dec9652012-06-06 16:15:03 +0200442 TARGET_CFLAGS = -D_MSGQSUPPORT
443 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100444endif
445
Christian Lachnerc1322302020-02-10 10:29:13 +0100446# AIX 7.2 and above
447ifeq ($(TARGET),aix72-gcc)
448 set_target_defaults = $(call default_opts, \
449 USE_POLL USE_THREAD USE_LIBCRYPT USE_OBSOLETE_LINKER USE_GETADDRINFO)
450 TARGET_CFLAGS = -D_H_XMEM -D_H_VAR
451 TARGET_LDFLAGS = -latomic
452endif
453
Willy Tarreau39f19922019-03-27 11:44:19 +0100454# Cygwin
Yitzhak Sapir32087312009-06-14 18:27:54 +0200455ifeq ($(TARGET),cygwin)
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100456 set_target_defaults = $(call default_opts, \
457 USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -0700458 # Cygwin adds IPv6 support only in version 1.7 (in beta right now).
Yitzhak Sapir32087312009-06-14 18:27:54 +0200459 TARGET_CFLAGS = $(if $(filter 1.5.%, $(shell uname -r)), -DUSE_IPV6 -DAF_INET6=23 -DINET6_ADDRSTRLEN=46, )
Willy Tarreau39f19922019-03-27 11:44:19 +0100460endif
willy tarreau4373b962005-12-18 01:32:31 +0100461
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100462# set the default settings according to the target above
463$(set_target_defaults)
464
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100465#### Determine version, sub-version and release date.
466# If GIT is found, and IGNOREGIT is not set, VERSION, SUBVERS and VERDATE are
467# extracted from the last commit. Otherwise, use the contents of the files
468# holding the same names in the current directory.
willy tarreau0174f312005-12-18 01:02:42 +0100469
Willy Tarreau6620dbb2007-01-02 00:44:53 +0100470ifeq ($(IGNOREGIT),)
Willy Tarreau3c55efb2019-06-22 08:24:16 +0200471VERSION := $(shell [ -d .git/. ] && (git describe --tags --match 'v*' --abbrev=0 | cut -c 2-) 2>/dev/null)
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100472ifneq ($(VERSION),)
473# OK git is there and works.
Willy Tarreau30a6f642019-06-22 07:51:02 +0200474SUBVERS := $(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 +0100475VERDATE := $(shell git log -1 --pretty=format:%ci | cut -f1 -d' ' | tr '-' '/')
Willy Tarreauec692562007-09-09 23:31:11 +0200476endif
477endif
478
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100479# Last commit version not found, take it from the files.
Willy Tarreauec692562007-09-09 23:31:11 +0200480ifeq ($(VERSION),)
481VERSION := $(shell cat VERSION 2>/dev/null || touch VERSION)
482endif
483ifeq ($(SUBVERS),)
Willy Tarreau6173bbe2013-12-16 01:34:39 +0100484SUBVERS := $(shell (grep -v '\$$Format' SUBVERS 2>/dev/null || touch SUBVERS) | head -n 1)
Willy Tarreauec692562007-09-09 23:31:11 +0200485endif
486ifeq ($(VERDATE),)
Willy Tarreauf1ed3272014-01-26 00:39:22 +0100487VERDATE := $(shell (grep -v '^\$$Format' VERDATE 2>/dev/null || touch VERDATE) | head -n 1 | cut -f1 -d' ' | tr '-' '/')
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100488endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100489
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200490# this one is always empty by default and appended verbatim
491EXTRAVERSION =
492
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100493#### Build options
494# Do not change these ones, enable USE_* variables instead.
495OPTIONS_CFLAGS =
496OPTIONS_LDFLAGS =
497OPTIONS_OBJS =
Willy Tarreau77074d52006-11-12 23:57:19 +0100498
Willy Tarreauada5d092019-01-10 10:01:03 +0100499#### Extra objects to be built and integrated (used only for development)
500EXTRA_OBJS =
501
Willy Tarreau09fe5662019-03-27 10:36:35 +0100502# Return USE_xxx=$(USE_xxx) if the variable was set from the environment or the
503# command line.
504# Usage:
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100505# BUILD_OPTIONS += $(call ignore_implicit,USE_xxx)
Willy Tarreau09fe5662019-03-27 10:36:35 +0100506ignore_implicit = $(if $(subst environment,,$(origin $(1))), \
507 $(if $(subst command line,,$(origin $(1))),, \
508 $(1)=$($(1))), \
509 $(1)=$($(1))) \
Willy Tarreau77074d52006-11-12 23:57:19 +0100510
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100511# This variable collects all USE_* values except those set to "implicit". This
512# is used to report a list of all flags which were used to build this version.
513# Do not assign anything to it.
Willy Tarreau7728ed32019-03-27 13:20:08 +0100514BUILD_OPTIONS := $(foreach opt,$(use_opts),$(call ignore_implicit,$(opt)))
515BUILD_FEATURES := $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),+$(opt),-$(opt)))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100516
Willy Tarreau824cd002019-03-27 14:44:14 +0100517# All USE_* options have their equivalent macro defined in the code (some might
518# possibly be unused though)
519OPTIONS_CFLAGS += $(foreach opt,$(use_opts),$(if $($(opt)),-D$(opt),))
520
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100521ifneq ($(USE_LIBCRYPT),)
Matthieu Guegan496374e2020-11-20 10:50:39 +0100522ifneq ($(TARGET),openbsd)
David Carlier6c00eba2019-09-01 14:59:10 +0100523ifneq ($(TARGET),osx)
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100524OPTIONS_LDFLAGS += -lcrypt
525endif
David Carlier6c00eba2019-09-01 14:59:10 +0100526endif
Matthieu Guegan496374e2020-11-20 10:50:39 +0100527endif
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100528
William Lallemand82fe75c2012-10-23 10:25:10 +0200529ifneq ($(USE_ZLIB),)
Willy Tarreaue2f49442012-02-10 20:37:26 +0100530# Use ZLIB_INC and ZLIB_LIB to force path to zlib.h and libz.{a,so} if needed.
531ZLIB_INC =
532ZLIB_LIB =
Willy Tarreau824cd002019-03-27 14:44:14 +0100533OPTIONS_CFLAGS += $(if $(ZLIB_INC),-I$(ZLIB_INC))
Willy Tarreaue2f49442012-02-10 20:37:26 +0100534OPTIONS_LDFLAGS += $(if $(ZLIB_LIB),-L$(ZLIB_LIB)) -lz
William Lallemand82fe75c2012-10-23 10:25:10 +0200535endif
536
Willy Tarreau12840be2021-04-22 14:14:22 +0200537ifneq ($(USE_SLZ),)
538OPTIONS_OBJS += src/slz.o
539endif
540
Willy Tarreau77074d52006-11-12 23:57:19 +0100541ifneq ($(USE_POLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100542OPTIONS_OBJS += src/ev_poll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100543endif
544
545ifneq ($(USE_EPOLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100546OPTIONS_OBJS += src/ev_epoll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100547endif
548
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100549ifneq ($(USE_KQUEUE),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100550OPTIONS_OBJS += src/ev_kqueue.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100551endif
552
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000553ifneq ($(USE_EVPORTS),)
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000554OPTIONS_OBJS += src/ev_evports.o
555endif
556
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100557ifneq ($(USE_DL),)
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100558OPTIONS_LDFLAGS += -ldl
559endif
560
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200561ifneq ($(USE_RT),)
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200562OPTIONS_LDFLAGS += -lrt
563endif
564
Willy Tarreauc0bbdc12020-03-04 08:31:47 +0100565ifneq ($(USE_THREAD),)
566OPTIONS_LDFLAGS += -lpthread
567endif
568
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100569ifneq ($(USE_BACKTRACE),)
570OPTIONS_LDFLAGS += -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic)
571endif
572
Amaury Denoyellef75c6402021-04-14 15:03:51 +0200573ifneq ($(USE_CPU_AFFINITY),)
574OPTIONS_OBJS += src/cpuset.o
575endif
576
Emeric Brun7444f012012-05-18 15:48:30 +0200577ifneq ($(USE_OPENSSL),)
Ilya Shipitsinf21023e2020-08-04 15:36:24 +0500578SSL_INC =
579SSL_LIB =
David CARLIER7385f652015-11-06 15:13:06 +0000580# OpenSSL is packaged in various forms and with various dependencies.
Emeric Brun7444f012012-05-18 15:48:30 +0200581# In general -lssl is enough, but on some platforms, -lcrypto may be needed,
Willy Tarreau8f182d92012-09-10 09:11:22 +0200582# reason why it's added by default. Some even need -lz, then you'll need to
Willy Tarreau9a059452013-09-17 15:26:39 +0200583# pass it in the "ADDLIB" variable if needed. If your SSL libraries are not
584# in the usual path, use SSL_INC=/path/to/inc and SSL_LIB=/path/to/lib.
Willy Tarreau824cd002019-03-27 14:44:14 +0100585OPTIONS_CFLAGS += $(if $(SSL_INC),-I$(SSL_INC))
Willy Tarreaucd360ce2014-10-31 07:36:51 +0100586OPTIONS_LDFLAGS += $(if $(SSL_LIB),-L$(SSL_LIB)) -lssl -lcrypto
Dirkjan Bussink1866d6d2016-08-29 13:26:37 +0200587ifneq ($(USE_DL),)
588OPTIONS_LDFLAGS += -ldl
589endif
William Lallemand6a66a5e2020-05-15 12:01:17 +0200590OPTIONS_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 +0100591endif
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100592ifneq ($(USE_QUIC),)
593OPTIONS_OBJS += src/quic_sock.o src/proto_quic.o src/xprt_quic.o src/quic_tls.o \
594 src/quic_frame.o src/quic_cc.o src/quic_cc_newreno.o
595endif
William Lallemandb620e982017-11-02 16:00:51 +0100596
597# The private cache option affect the way the shctx is built
Willy Tarreau824cd002019-03-27 14:44:14 +0100598ifeq ($(USE_PRIVATE_CACHE),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200599ifneq ($(USE_PTHREAD_PSHARED),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200600OPTIONS_LDFLAGS += -lpthread
Emeric Bruncd1a5262014-05-07 23:11:42 +0200601endif
Emeric Brun3e541d12012-09-03 11:14:36 +0200602endif
Olivier Houchard2292edf2019-02-25 14:26:54 +0100603
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100604ifneq ($(USE_LUA),)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100605check_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 +0800606check_lua_inc = $(shell if [ -d $(2)$(1) ]; then echo $(2)$(1); fi;)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100607
Willy Tarreau824cd002019-03-27 14:44:14 +0100608OPTIONS_CFLAGS += $(if $(LUA_INC),-I$(LUA_INC))
Thierry Fournier13113d62018-02-26 09:25:56 +0100609LUA_LD_FLAGS := -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic) $(if $(LUA_LIB),-L$(LUA_LIB))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100610ifeq ($(LUA_LIB_NAME),)
611# Try to automatically detect the Lua library
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100612LUA_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 +0100613ifeq ($(LUA_LIB_NAME),)
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100614$(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 +0100615endif
Nan Liub286fff2017-06-09 15:57:45 +0800616LUA_INC := $(firstword $(foreach lib,lua5.3 lua53 lua,$(call check_lua_inc,$(lib),"/usr/include/")))
617ifneq ($(LUA_INC),)
618OPTIONS_CFLAGS += -I$(LUA_INC)
619endif
Tim Duesterhus541fe1e2020-01-12 13:55:41 +0100620ifneq ($(HLUA_PREPEND_PATH),)
621OPTIONS_CFLAGS += -DHLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
622BUILD_OPTIONS += HLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
623endif
624ifneq ($(HLUA_PREPEND_CPATH),)
625OPTIONS_CFLAGS += -DHLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
626BUILD_OPTIONS += HLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
627endif
Cyril Bontéc21adb52015-03-03 23:13:03 +0100628endif
629
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100630OPTIONS_LDFLAGS += $(LUA_LD_FLAGS) -l$(LUA_LIB_NAME) -lm
Vincent Bernate192cbb2015-07-16 20:52:51 +0200631ifneq ($(USE_DL),)
632OPTIONS_LDFLAGS += -ldl
633endif
Thierry Fournierfb0b5462016-01-21 09:28:58 +0100634OPTIONS_OBJS += src/hlua.o src/hlua_fcn.o
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100635endif
636
Willy Tarreau92dc7862021-04-02 15:31:10 +0200637ifneq ($(USE_PROMEX),)
Willy Tarreau3dfadc72021-04-02 15:35:19 +0200638OPTIONS_OBJS += addons/promex/service-prometheus.o
Willy Tarreau92dc7862021-04-02 15:31:10 +0200639endif
640
David Carliera03fb142015-06-01 14:00:07 +0200641ifneq ($(USE_DEVICEATLAS),)
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200642# Use DEVICEATLAS_SRC and possibly DEVICEATLAS_INC and DEVICEATLAS_LIB to force path
Dragan Dosen93b38d92015-06-29 16:43:25 +0200643# to DeviceAtlas headers and libraries if needed.
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200644DEVICEATLAS_SRC =
645DEVICEATLAS_INC = $(DEVICEATLAS_SRC)
646DEVICEATLAS_LIB = $(DEVICEATLAS_SRC)
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100647ifeq ($(DEVICEATLAS_SRC),)
648OPTIONS_LDFLAGS += -lda
649else
David Carlier019dbd72021-02-16 11:37:45 +0000650ifeq ($(USE_PCRE),)
651ifeq ($(USE_PCRE2),)
652$(error the DeviceAtlas module needs the PCRE or the PCRE2 library in order to compile)
653endif
654endif
655ifneq ($(USE_PCRE2),)
656OPTIONS_CFLAGS += -DDA_REGEX_HDR=\"dac_pcre2.c\" -DDA_REGEX_TAG=2
657endif
David Carliera03fb142015-06-01 14:00:07 +0200658OPTIONS_OBJS += $(DEVICEATLAS_LIB)/json.o
659OPTIONS_OBJS += $(DEVICEATLAS_LIB)/dac.o
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100660endif
Willy Tarreauf8d9ec52021-04-02 16:19:39 +0200661OPTIONS_OBJS += addons/deviceatlas/da.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100662OPTIONS_CFLAGS += $(if $(DEVICEATLAS_INC),-I$(DEVICEATLAS_INC))
David Carliera03fb142015-06-01 14:00:07 +0200663endif
664
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100665ifneq ($(USE_51DEGREES),)
Willy Tarreauc7203c72015-06-01 11:12:35 +0200666# Use 51DEGREES_SRC and possibly 51DEGREES_INC and 51DEGREES_LIB to force path
667# to 51degrees headers and libraries if needed.
66851DEGREES_SRC =
66951DEGREES_INC = $(51DEGREES_SRC)
67051DEGREES_LIB = $(51DEGREES_SRC)
James Rosewell3670eb12015-09-18 17:24:29 +0100671OPTIONS_OBJS += $(51DEGREES_LIB)/../cityhash/city.o
Dragan Dosen93b38d92015-06-29 16:43:25 +0200672OPTIONS_OBJS += $(51DEGREES_LIB)/51Degrees.o
Willy Tarreau977209d2021-04-02 16:12:32 +0200673OPTIONS_OBJS += addons/51degrees/51d.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100674OPTIONS_CFLAGS += $(if $(51DEGREES_INC),-I$(51DEGREES_INC))
Ben51Degrees4ddf59d2019-02-05 13:24:00 +0000675ifeq ($(USE_THREAD),)
676OPTIONS_CFLAGS += -DFIFTYONEDEGREES_NO_THREADING
677else
678OPTIONS_OBJS += $(51DEGREES_LIB)/../threading.o
679endif
680
James Rosewell3670eb12015-09-18 17:24:29 +0100681OPTIONS_LDFLAGS += $(if $(51DEGREES_LIB),-L$(51DEGREES_LIB)) -lm
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100682endif
683
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200684ifneq ($(USE_WURFL),)
685# Use WURFL_SRC and possibly WURFL_INC and WURFL_LIB to force path
686# to WURFL headers and libraries if needed.
687WURFL_SRC =
688WURFL_INC = $(WURFL_SRC)
689WURFL_LIB = $(WURFL_SRC)
Willy Tarreau57610c62021-04-02 16:39:44 +0200690OPTIONS_OBJS += addons/wurfl/wurfl.o
Willy Tarreau14261982019-04-23 10:57:09 +0200691OPTIONS_CFLAGS += $(if $(WURFL_INC),-I$(WURFL_INC))
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200692ifneq ($(WURFL_DEBUG),)
693OPTIONS_CFLAGS += -DWURFL_DEBUG
694endif
695ifneq ($(WURFL_HEADER_WITH_DETAILS),)
696OPTIONS_CFLAGS += -DWURFL_HEADER_WITH_DETAILS
697endif
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200698OPTIONS_LDFLAGS += $(if $(WURFL_LIB),-L$(WURFL_LIB)) -lwurfl
699endif
700
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100701ifneq ($(USE_SYSTEMD),)
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100702OPTIONS_LDFLAGS += -lsystemd
703endif
704
Hiroaki Nakamura70351322013-01-13 15:00:42 +0900705ifneq ($(USE_PCRE)$(USE_STATIC_PCRE)$(USE_PCRE_JIT),)
David Carlierf2592b22016-11-21 21:25:58 +0000706ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
707$(error cannot compile both PCRE and PCRE2 support)
708endif
Willy Tarreau39793092013-02-13 12:39:06 +0100709# PCREDIR is used to automatically construct the PCRE_INC and PCRE_LIB paths,
710# by appending /include and /lib respectively. If your system does not use the
711# same sub-directories, simply force these variables instead of PCREDIR. It is
712# automatically detected but can be forced if required (for cross-compiling).
713# Forcing PCREDIR to an empty string will let the compiler use the default
714# locations.
715
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200716PCRE_CONFIG := pcre-config
717PCREDIR := $(shell $(PCRE_CONFIG) --prefix 2>/dev/null || echo /usr/local)
Willy Tarreau39793092013-02-13 12:39:06 +0100718ifneq ($(PCREDIR),)
719PCRE_INC := $(PCREDIR)/include
720PCRE_LIB := $(PCREDIR)/lib
Willy Tarreau79b34bf2006-12-22 15:28:43 +0100721endif
Willy Tarreau39793092013-02-13 12:39:06 +0100722
Christian Wiesec8203002008-11-20 14:47:04 +0100723ifeq ($(USE_STATIC_PCRE),)
Willy Tarreau39793092013-02-13 12:39:06 +0100724# dynamic PCRE
725OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
726OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -lpcreposix -lpcre
Willy Tarreau39793092013-02-13 12:39:06 +0100727else
728# static PCRE
729OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
730OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -Wl,-Bstatic -lpcreposix -lpcre -Wl,-Bdynamic
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100731endif
Willy Tarreau39793092013-02-13 12:39:06 +0100732endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100733
David Carlierf2592b22016-11-21 21:25:58 +0000734ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200735PCRE2_CONFIG := pcre2-config
736PCRE2DIR := $(shell $(PCRE2_CONFIG) --prefix 2>/dev/null || echo /usr/local)
David Carlierf2592b22016-11-21 21:25:58 +0000737ifneq ($(PCRE2DIR),)
738PCRE2_INC := $(PCRE2DIR)/include
739PCRE2_LIB := $(PCRE2DIR)/lib
740
741ifeq ($(PCRE2_WIDTH),)
742PCRE2_WIDTH = 8
743endif
744
745ifneq ($(PCRE2_WIDTH),8)
746ifneq ($(PCRE2_WIDTH),16)
747ifneq ($(PCRE2_WIDTH),32)
748$(error PCRE2_WIDTH needs to be set to either 8,16 or 32)
749endif
750endif
751endif
752
753
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200754PCRE2_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 +0000755
756ifeq ($(PCRE2_LDFLAGS),)
757$(error libpcre2-$(PCRE2_WIDTH) not found)
758else
759ifeq ($(PCRE2_WIDTH),8)
760PCRE2_LDFLAGS += -lpcre2-posix
761endif
762endif
763
764OPTIONS_CFLAGS += -DUSE_PCRE2 -DPCRE2_CODE_UNIT_WIDTH=$(PCRE2_WIDTH)
765OPTIONS_CFLAGS += $(if $(PCRE2_INC), -I$(PCRE2_INC))
766
767ifneq ($(USE_STATIC_PCRE2),)
768OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -Wl,-Bstatic -L$(PCRE2_LIB) $(PCRE2_LDFLAGS) -Wl,-Bdynamic
David Carlierf2592b22016-11-21 21:25:58 +0000769else
770OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -L$(PCRE2_LIB) $(PCRE2_LDFLAGS)
David Carlierf2592b22016-11-21 21:25:58 +0000771endif
772
David Carlierf2592b22016-11-21 21:25:58 +0000773endif
774endif
775
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100776#### Global compile options
777VERBOSE_CFLAGS = $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE)
Willy Tarreaufc80e302020-05-27 11:05:33 +0200778COPTS = -Iinclude
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200779
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100780COPTS += $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE) $(SILENT_DEFINE)
781COPTS += $(DEBUG) $(OPTIONS_CFLAGS) $(ADDINC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100782
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200783ifneq ($(VERSION)$(SUBVERS)$(EXTRAVERSION),)
784COPTS += -DCONFIG_HAPROXY_VERSION=\"$(VERSION)$(SUBVERS)$(EXTRAVERSION)\"
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100785endif
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100786
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100787ifneq ($(VERDATE),)
788COPTS += -DCONFIG_HAPROXY_DATE=\"$(VERDATE)\"
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100789endif
790
Willy Tarreau7de211c2012-05-25 23:53:16 +0200791ifneq ($(TRACE),)
792# if tracing is enabled, we want it to be as fast as possible
793TRACE_COPTS := $(filter-out -O0 -O1 -O2 -pg -finstrument-functions,$(COPTS)) -O3 -fomit-frame-pointer
794COPTS += -finstrument-functions
795endif
796
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100797ifneq ($(USE_NS),)
Willy Tarreau7520e4f2018-11-11 14:38:09 +0100798OPTIONS_OBJS += src/namespace.o
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100799endif
800
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100801ifneq ($(USE_OT),)
Willy Tarreaua63d1a02021-04-02 17:16:46 +0200802include addons/ot/Makefile
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100803endif
804
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100805#### Global link options
806# These options are added at the end of the "ld" command line. Use LDFLAGS to
807# add options at the beginning of the "ld" command line if needed.
808LDOPTS = $(TARGET_LDFLAGS) $(OPTIONS_LDFLAGS) $(ADDLIB)
willy tarreau0f7af912005-12-17 12:21:26 +0100809
Willy Tarreau16119652018-11-19 08:15:54 +0100810ifeq ($V,1)
811cmd_CC = $(CC)
812cmd_LD = $(LD)
813cmd_AR = $(AR)
814else
815cmd_CC = $(Q)echo " CC $@";$(CC)
816cmd_LD = $(Q)echo " LD $@";$(LD)
817cmd_AR = $(Q)echo " AR $@";$(AR)
818endif
819
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100820ifeq ($(TARGET),)
821all:
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100822 @echo "Building HAProxy without specifying a TARGET is not supported."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100823 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100824 @echo "Usage:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100825 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100826 @echo " $ make help # To print a full explanation."
827 @echo " $ make TARGET=xxx USE_<feature>=1 # To build HAProxy."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100828 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100829 @echo "The most commonly used targets are:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100830 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100831 @echo " linux-glibc - Modern Linux with glibc"
832 @echo " linux-musl - Modern Linux with musl"
833 @echo " freebsd - FreeBSD"
834 @echo " openbsd - OpenBSD"
835 @echo " netbsd - NetBSD"
836 @echo " osx - macOS"
837 @echo " solaris - Solaris"
838 @echo
839 @echo "Choose the target which matches your OS the most in order to"
840 @echo "gain the maximum performance out of it."
841 @echo
842 @echo "Common features you might want to include in your build are:"
843 @echo
844 @echo " USE_OPENSSL=1 - Support for TLS encrypted connections"
845 @echo " USE_ZLIB=1 - Support for HTTP response compression"
846 @echo " USE_PCRE=1 - Support for PCRE regular expressions"
847 @echo " USE_LUA=1 - Support for dynamic processing using Lua"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100848 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100849 @echo "Use 'make help' to print a full explanation of supported targets"
850 @echo "and features."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100851 @echo
852 @exit 1
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200853else
854ifneq ($(filter $(TARGET), linux linux22 linux24 linux24e linux26 linux2628),)
Willy Tarreau99e49e92019-06-14 16:44:49 +0200855all:
856 @echo
857 @echo "Target '$(TARGET)' was removed from HAProxy 2.0 due to being irrelevant and"
858 @echo "often wrong. Please use 'linux-glibc' instead or define your custom target"
859 @echo "by checking available options using 'make help TARGET=<your-target>'."
860 @echo
861 @exit 1
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100862else
Willy Tarreau888bda02021-04-02 13:59:17 +0200863all: haproxy dev/flags/flags $(EXTRA)
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100864endif
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200865endif
willy tarreau0f7af912005-12-17 12:21:26 +0100866
Willy Tarreau2404e372020-11-05 16:42:25 +0100867OBJS =
Willy Tarreau7de211c2012-05-25 23:53:16 +0200868
Willy Tarreauada5d092019-01-10 10:01:03 +0100869ifneq ($(EXTRA_OBJS),)
870OBJS += $(EXTRA_OBJS)
871endif
Marc-Antoine Perennoued9803e2013-02-12 10:53:53 +0100872
Willy Tarreau1d142622021-05-08 23:33:25 +0200873OBJS += src/mux_h2.o src/mux_fcgi.o src/http_ana.o src/mux_h1.o src/stream.o \
874 src/tcpcheck.o src/stats.o src/flt_spoe.o src/server.o src/tools.o \
875 src/sample.o src/log.o src/backend.o src/stick_table.o src/cfgparse.o \
876 src/peers.o src/cli.o src/pattern.o src/resolvers.o src/proxy.o \
877 src/http_htx.o src/check.o src/cache.o src/cfgparse-listen.o \
878 src/haproxy.o src/http_act.o src/stream_interface.o src/http_fetch.o \
879 src/listener.o src/dns.o src/connection.o src/tcp_rules.o src/debug.o \
880 src/sink.o src/payload.o src/mux_pt.o src/filters.o src/fcgi-app.o \
881 src/server_state.o src/vars.o src/map.o src/cfgparse-global.o \
882 src/task.o src/flt_http_comp.o src/session.o src/sock.o \
883 src/flt_trace.o src/acl.o src/trace.o src/http_rules.o src/queue.o \
884 src/mjson.o src/h2.o src/h1.o src/mworker.o src/lb_chash.o src/ring.o \
885 src/activity.o src/tcp_sample.o src/proto_tcp.o src/htx.o src/h1_htx.o \
886 src/extcheck.o src/channel.o src/proto_sockpair.o src/fd.o \
887 src/compression.o src/mqtt.o src/tcp_act.o src/raw_sock.o \
888 src/frontend.o src/http_conv.o src/xprt_handshake.o src/pool.o \
889 src/applet.o src/mailers.o src/lb_fwrr.o src/lb_fwlc.o src/lb_fas.o \
890 src/proto_uxst.o src/http.o src/action.o src/protocol.o src/thread.o \
891 src/sock_unix.o src/proto_udp.o src/lb_map.o src/sock_inet.o src/lru.o \
892 src/cfgparse-tcp.o src/cfgdiag.o src/proto_uxdg.o src/ev_select.o \
893 src/cfgparse-unix.o src/uri_normalizer.o src/ebmbtree.o src/sha1.o \
894 src/time.o src/signal.o src/mworker-prog.o src/hpack-dec.o src/fix.o \
895 src/arg.o src/eb64tree.o src/chunk.o src/shctx.o src/regex.o \
896 src/fcgi.o src/eb32tree.o src/eb32sctree.o src/dynbuf.o src/uri_auth.o \
897 src/hpack-tbl.o src/ebimtree.o src/auth.o src/ebsttree.o \
898 src/ebistree.o src/base64.o src/wdt.o src/pipe.o src/http_acl.o \
899 src/hpack-enc.o src/dict.o src/dgram.o src/init.o src/hpack-huff.o \
900 src/freq_ctr.o src/ebtree.o src/hash.o src/version.o
Willy Tarreau2404e372020-11-05 16:42:25 +0100901
902ifneq ($(TRACE),)
903OBJS += src/calltrace.o
904endif
905
Willy Tarreaub26835d2016-05-30 13:39:32 +0200906# Used only for forced dependency checking. May be cleared during development.
Willy Tarreaufc80e302020-05-27 11:05:33 +0200907INCLUDES = $(wildcard include/*/*.h)
Willy Tarreau8225bb42016-05-30 15:16:10 +0200908DEP = $(INCLUDES) .build_opts
909
William Lallemandf1b60f72018-12-13 14:02:25 +0100910help:
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000911 @sed -ne "/^[^#]*$$/q;s/^# \{0,1\}\(.*\)/\1/;p" Makefile
912 @echo; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200913 if [ -n "$(TARGET)" ]; then \
Willy Tarreau5fb76032019-06-16 19:26:18 +0200914 if [ -n "$(set_target_defaults)" ]; then \
915 echo "Current TARGET: $(TARGET)"; \
916 else \
917 echo "Current TARGET: $(TARGET) (custom target)"; \
918 fi; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200919 else \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200920 echo "TARGET not set, you may pass 'TARGET=xxx' to set one among :";\
Brad Smith382001b2020-10-08 01:15:06 -0400921 echo " linux-glibc, linux-glibc-legacy, solaris, freebsd, dragonfly, netbsd,"; \
922 echo " osx, openbsd, aix51, aix52, aix72-gcc, cygwin, haiku, generic,"; \
923 echo " custom"; \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200924 fi
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000925 @echo;echo "Enabled features for TARGET '$(TARGET)' (disable with 'USE_xxx=') :"
926 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),$(opt),)); echo " $$*" | (fmt || cat) 2>/dev/null
927 @echo;echo "Disabled features for TARGET '$(TARGET)' (enable with 'USE_xxx=1') :"
928 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),,$(opt))); echo " $$*" | (fmt || cat) 2>/dev/null
William Lallemandf1b60f72018-12-13 14:02:25 +0100929
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100930# Used only to force a rebuild if some build options change, but we don't do
931# it for certain targets which take no build options
932ifneq (reg-tests, $(firstword $(MAKECMDGOALS)))
Tim Duesterhus81e948e2020-11-21 18:07:58 +0100933build_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 +0100934.build_opts: $(build_opts)
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100935else
936.build_opts:
937endif
Willy Tarreaub26835d2016-05-30 13:39:32 +0200938
Willy Tarreauff0e8a42020-05-27 10:43:24 +0200939haproxy: $(OPTIONS_OBJS) $(OBJS)
Willy Tarreau16119652018-11-19 08:15:54 +0100940 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
willy tarreau0f7af912005-12-17 12:21:26 +0100941
Willy Tarreaubaaee002006-06-26 02:48:02 +0200942objsize: haproxy
Willy Tarreaub42233a2018-11-19 07:44:42 +0100943 $(Q)objdump -t $^|grep ' g '|grep -F '.text'|awk '{print $$5 FS $$6}'|sort
Willy Tarreaubaaee002006-06-26 02:48:02 +0200944
Willy Tarreaub26835d2016-05-30 13:39:32 +0200945%.o: %.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100946 $(cmd_CC) $(COPTS) -c -o $@ $<
willy tarreau0f7af912005-12-17 12:21:26 +0100947
Willy Tarreaua9f16c62021-04-02 14:46:21 +0200948admin/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
949 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200950
Willy Tarreau8f72d482021-08-11 13:54:52 +0200951admin/dyncookie/dyncookie: admin/dyncookie/dyncookie.o
952 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
953
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200954dev/flags/flags: dev/flags/flags.o
955 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200956
Willy Tarreau21ef8b92021-04-02 14:27:26 +0200957dev/hpack/%: dev/hpack/%.o
958 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
959
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200960dev/poll/poll:
961 $(Q)$(MAKE) -C dev/poll poll CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200962
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200963dev/tcploop/tcploop:
964 $(Q)$(MAKE) -C dev/tcploop tcploop CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200965
Willy Tarreau909b9d82019-01-04 18:20:32 +0100966# rebuild it every time
967.PHONY: src/version.c
968
Willy Tarreau9eebd8a2019-08-08 16:53:40 +0200969src/calltrace.o: src/calltrace.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100970 $(cmd_CC) $(TRACE_COPTS) -c -o $@ $<
Willy Tarreau7de211c2012-05-25 23:53:16 +0200971
Willy Tarreaub26835d2016-05-30 13:39:32 +0200972src/haproxy.o: src/haproxy.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100973 $(cmd_CC) $(COPTS) \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100974 -DBUILD_TARGET='"$(strip $(TARGET))"' \
Willy Tarreauef7341d2009-04-11 19:45:50 +0200975 -DBUILD_ARCH='"$(strip $(ARCH))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100976 -DBUILD_CPU='"$(strip $(CPU))"' \
977 -DBUILD_CC='"$(strip $(CC))"' \
978 -DBUILD_CFLAGS='"$(strip $(VERBOSE_CFLAGS))"' \
979 -DBUILD_OPTIONS='"$(strip $(BUILD_OPTIONS))"' \
Tim Duesterhusc8d19702020-11-21 18:07:59 +0100980 -DBUILD_DEBUG='"$(strip $(DEBUG))"' \
Willy Tarreau7728ed32019-03-27 13:20:08 +0100981 -DBUILD_FEATURES='"$(strip $(BUILD_FEATURES))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100982 -c -o $@ $<
Willy Tarreau7b066db2007-12-02 11:28:59 +0100983
Christian Wiese19b50292008-03-12 15:57:54 +0200984install-man:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100985 $(Q)install -v -d "$(DESTDIR)$(MANDIR)"/man1
986 $(Q)install -v -m 644 doc/haproxy.1 "$(DESTDIR)$(MANDIR)"/man1
Christian Wiese19b50292008-03-12 15:57:54 +0200987
Vincent Bernat5c5147f2015-10-13 22:20:55 +0200988EXCLUDE_DOCUMENTATION = lgpl gpl coding-style
989DOCUMENTATION = $(filter-out $(EXCLUDE_DOCUMENTATION),$(patsubst doc/%.txt,%,$(wildcard doc/*.txt)))
990
Christian Wiesebf34eb42008-03-12 17:24:49 +0200991install-doc:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100992 $(Q)install -v -d "$(DESTDIR)$(DOCDIR)"
993 $(Q)for x in $(DOCUMENTATION); do \
994 install -v -m 644 doc/$$x.txt "$(DESTDIR)$(DOCDIR)" ; \
Christian Wiesebf34eb42008-03-12 17:24:49 +0200995 done
996
Willy Tarreau13d67bb2016-06-24 18:30:22 +0200997install-bin:
Willy Tarreaub42233a2018-11-19 07:44:42 +0100998 $(Q)for i in haproxy $(EXTRA); do \
Willy Tarreau13d67bb2016-06-24 18:30:22 +0200999 if ! [ -e "$$i" ]; then \
1000 echo "Please run 'make' before 'make install'."; \
1001 exit 1; \
1002 fi; \
1003 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001004 $(Q)install -v -d "$(DESTDIR)$(SBINDIR)"
1005 $(Q)install -v haproxy $(EXTRA) "$(DESTDIR)$(SBINDIR)"
Christian Wiesea184aa22008-03-12 15:25:35 +02001006
Christian Wiesedb5238d2008-03-12 18:28:13 +02001007install: install-bin install-man install-doc
Christian Wiese4cf5d572008-03-12 16:21:05 +02001008
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001009uninstall:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001010 $(Q)rm -f "$(DESTDIR)$(MANDIR)"/man1/haproxy.1
1011 $(Q)for x in $(DOCUMENTATION); do \
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001012 rm -f "$(DESTDIR)$(DOCDIR)"/$$x.txt ; \
1013 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001014 $(Q)-rmdir "$(DESTDIR)$(DOCDIR)"
1015 $(Q)rm -f "$(DESTDIR)$(SBINDIR)"/haproxy
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001016
willy tarreau0f7af912005-12-17 12:21:26 +01001017clean:
Willy Tarreauff0e8a42020-05-27 10:43:24 +02001018 $(Q)rm -f *.[oas] src/*.[oas] haproxy test .build_opts .build_opts.new
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001019 $(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 +02001020 $(Q)rm -f haproxy-$(VERSION).tar.gz haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1021 $(Q)rm -f haproxy-$(VERSION) haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) nohup.out gmon.out
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001022 $(Q)rm -f addons/promex/*.[oas]
Willy Tarreau977209d2021-04-02 16:12:32 +02001023 $(Q)rm -f addons/51degrees/*.[oas] addons/51degrees/dummy/*.[oas] addons/51degrees/dummy/*/*.[oas]
Willy Tarreauf8d9ec52021-04-02 16:19:39 +02001024 $(Q)rm -f addons/deviceatlas/*.[oas] addons/deviceatlas/dummy/*.[oas]
Willy Tarreaua63d1a02021-04-02 17:16:46 +02001025 $(Q)rm -f addons/ot/src/*.[oas]
Willy Tarreau57610c62021-04-02 16:39:44 +02001026 $(Q)rm -f addons/wurfl/*.[oas] addons/wurfl/dummy/*.[oas]
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001027 $(Q)rm -f admin/*/*.[oas] admin/*/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001028 $(Q)rm -f admin/iprange/iprange admin/iprange/ip6range admin/halog/halog
Willy Tarreau8f72d482021-08-11 13:54:52 +02001029 $(Q)rm -f admin/dyncookie/dyncookie
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001030 $(Q)rm -f dev/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001031 $(Q)rm -f dev/flags/flags dev/poll/poll dev/tcploop/tcploop
Willy Tarreau21ef8b92021-04-02 14:27:26 +02001032 $(Q)rm -f dev/hpack/decode dev/hpack/gen-enc dev/hpack/gen-rht
willy tarreauefae1842005-12-17 12:51:03 +01001033
Willy Tarreauebe0af42009-10-10 22:20:44 +02001034tags:
Willy Tarreau6db82662018-11-19 08:14:40 +01001035 $(Q)find src include \( -name '*.c' -o -name '*.h' \) -print0 | \
Willy Tarreauebe0af42009-10-10 22:20:44 +02001036 xargs -0 etags --declarations --members
1037
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001038cscope:
Willy Tarreau6db82662018-11-19 08:14:40 +01001039 $(Q)find src include -name "*.[ch]" -print | cscope -q -b -i -
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001040
willy tarreaue114bf92006-03-19 21:30:14 +01001041tar: clean
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001042 $(Q)ln -s . haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
1043 $(Q)tar --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/.git \
1044 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) \
1045 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz \
1046 -cf - haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/* | gzip -c9 >haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1047 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1048 $(Q)rm -f haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
willy tarreaucee272f2006-03-19 21:16:26 +01001049
Willy Tarreau05ed29c2012-12-20 15:00:44 +01001050git-tar:
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001051 $(Q)git archive --format=tar --prefix="haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/" HEAD | gzip -9 > haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1052 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
Willy Tarreauec692562007-09-09 23:31:11 +02001053
1054version:
1055 @echo "VERSION: $(VERSION)"
1056 @echo "SUBVERS: $(SUBVERS)"
1057 @echo "VERDATE: $(VERDATE)"
1058
1059# never use this one if you don't know what it is used for.
1060update-version:
1061 @echo "Ready to update the following versions :"
1062 @echo "VERSION: $(VERSION)"
1063 @echo "SUBVERS: $(SUBVERS)"
1064 @echo "VERDATE: $(VERDATE)"
1065 @echo "Press [ENTER] to continue or Ctrl-C to abort now.";read
1066 echo "$(VERSION)" > VERSION
1067 echo "$(SUBVERS)" > SUBVERS
1068 echo "$(VERDATE)" > VERDATE
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001069
Willy Tarreaua8b12c62018-10-03 09:40:22 +02001070# just display the build options
1071opts:
1072 @echo -n 'Using: '
1073 @echo -n 'TARGET="$(strip $(TARGET))" '
1074 @echo -n 'ARCH="$(strip $(ARCH))" '
1075 @echo -n 'CPU="$(strip $(CPU))" '
1076 @echo -n 'CC="$(strip $(CC))" '
1077 @echo -n 'ARCH_FLAGS="$(strip $(ARCH_FLAGS))" '
1078 @echo -n 'CPU_CFLAGS="$(strip $(CPU_CFLAGS))" '
1079 @echo -n 'DEBUG_CFLAGS="$(strip $(DEBUG_CFLAGS))" '
1080 @echo "$(strip $(BUILD_OPTIONS))"
1081 @echo 'COPTS="$(strip $(COPTS))"'
1082 @echo 'LDFLAGS="$(strip $(LDFLAGS))"'
1083 @echo 'LDOPTS="$(strip $(LDOPTS))"'
1084 @echo 'OPTIONS_OBJS="$(strip $(OPTIONS_OBJS))"'
1085 @echo 'OBJS="$(strip $(OBJS))"'
1086
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001087ifeq (reg-tests, $(firstword $(MAKECMDGOALS)))
1088 REGTEST_ARGS := $(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))
1089 $(eval $(REGTEST_ARGS):;@true)
1090endif
1091
Frédéric Lécaille99316342018-08-22 10:41:33 +02001092# Target to run the regression testing script files.
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001093reg-tests:
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001094 $(Q)$(REG_TEST_SCRIPT) --type "$(REGTESTS_TYPES)" $(REGTEST_ARGS) $(REG_TEST_FILES)
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001095.PHONY: $(REGTEST_ARGS)
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001096
1097reg-tests-help:
1098 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001099 @echo "To launch the reg tests for haproxy, first export to your environment "
1100 @echo "VTEST_PROGRAM variable to point to your vtest program:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001101 @echo " $$ export VTEST_PROGRAM=/opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001102 @echo "or"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001103 @echo " $$ setenv VTEST_PROGRAM /opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001104 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001105 @echo "The same thing may be done to set your haproxy program with HAPROXY_PROGRAM "
1106 @echo "but with ./haproxy as default value."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001107 @echo
1108 @echo "To run all the tests:"
1109 @echo " $$ make reg-tests"
1110 @echo
1111 @echo "You can also set the programs to be used on the command line:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001112 @echo " $$ VTEST_PROGRAM=<...> HAPROXY_PROGRAM=<...> make reg-tests"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001113 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001114 @echo "To run tests with specific types:"
1115 @echo " $$ REGTESTS_TYPES=slow,default make reg-tests"
1116 @echo
William Lallemandc1ddcaf2021-02-05 11:27:54 +01001117 @echo "with 'default,bug,devel,slow' as default value for REGTESTS_TYPES variable."
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001118 @echo
1119 @echo "About the reg test types:"
1120 @echo " any : all the tests without distinction (this is the default"
1121 @echo " value of REGTESTS_TYPES."
1122 @echo " default : dedicated to pure haproxy compliance tests."
1123 @echo " slow : scripts which take non negligible time to run."
1124 @echo " bug : scripts in relation with bugs they help to reproduce."
1125 @echo " broken : scripts triggering known broken behaviors for which"
1126 @echo " there is still no fix."
1127 @echo " experimental: for scripts which are experimental, typically used to"
1128 @echo " develop new scripts."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001129 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001130 @echo "Note that 'reg-tests' target run '"$(REG_TEST_SCRIPT)"' script"
1131 @echo "(see --help option of this script for more information)."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001132
1133.PHONY: reg-tests reg-tests-help