blob: 82fa9ddb0cfa4d5eae0ae3540067995864ab0997 [file] [log] [blame]
Willy Tarreau9f2b7302008-01-02 20:48:34 +01001# This GNU Makefile supports different OS and CPU combinations.
2#
willy tarreaueedaa9f2005-12-17 14:08:03 +01003# You should use it this way :
Willy Tarreau50b1aae2019-06-14 15:52:01 +02004# [g]make TARGET=os [ARCH=arch] [CPU=cpu] USE_xxx=1 ...
5#
6# When in doubt, invoke help, possibly with a known target :
7# [g]make help
Willy Tarreau61cf0dc2019-06-14 16:32:09 +02008# [g]make help TARGET=linux-glibc
Willy Tarreauf2ef8c52007-07-11 09:19:31 +02009#
Willy Tarreau16119652018-11-19 08:15:54 +010010# By default the detailed commands are hidden for a cleaner output, but you may
11# see them by appending "V=1" to the make command.
12#
Willy Tarreau05fd82d2019-03-27 10:57:49 +010013# Valid USE_* options are enumerated in the "use_opts" variable and are listed
14# below. Most of them are automatically set by the TARGET, others have to be
15# explicitly specified :
Willy Tarreau9f2b7302008-01-02 20:48:34 +010016# USE_EPOLL : enable epoll() on Linux 2.6. Automatic.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010017# USE_KQUEUE : enable kqueue() on BSD. Automatic.
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +000018# USE_EVPORTS : enable event ports on SunOS systems. Automatic.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010019# USE_NETFILTER : enable netfilter on Linux. Automatic.
20# USE_PCRE : enable use of libpcre for regex. Recommended.
Willy Tarreau91418062013-04-04 23:05:32 +020021# USE_PCRE_JIT : enable JIT for faster regex on libpcre >= 8.32
David Carlierf2592b22016-11-21 21:25:58 +000022# USE_PCRE2 : enable use of libpcre2 for regex.
23# USE_PCRE2_JIT : enable JIT for faster regex on libpcre2
Willy Tarreau9f2b7302008-01-02 20:48:34 +010024# USE_POLL : enable poll(). Automatic.
Emeric Brun9faf0712012-09-25 11:11:16 +020025# USE_PRIVATE_CACHE : disable shared memory cache of ssl sessions.
Christopher Fauleta1ae7e82017-10-25 17:55:27 +020026# USE_THREAD : enable threads support.
Emeric Bruncd1a5262014-05-07 23:11:42 +020027# USE_PTHREAD_PSHARED : enable pthread process shared mutex on sslcache.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010028# USE_STATIC_PCRE : enable static libpcre. Recommended.
David Carlierf2592b22016-11-21 21:25:58 +000029# USE_STATIC_PCRE2 : enable static libpcre2.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010030# USE_TPROXY : enable transparent proxy. Automatic.
Willy Tarreaue0c623d2012-06-04 00:42:09 +020031# USE_LINUX_TPROXY : enable full transparent proxy. Automatic.
32# USE_LINUX_SPLICE : enable kernel 2.6 splicing. Automatic.
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -070033# USE_LIBCRYPT : enable encrypted passwords using -lcrypt
Willy Tarreau890a33e2010-03-04 19:10:14 +010034# USE_CRYPT_H : set it if your system requires including crypt.h
Willy Tarreau64bc40b2011-03-23 20:00:53 +010035# USE_GETADDRINFO : use getaddrinfo() to resolve IPv6 host names.
Emeric Brun7444f012012-05-18 15:48:30 +020036# USE_OPENSSL : enable use of OpenSSL. Recommended, but see below.
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +010037# USE_LUA : enable Lua support.
Emeric Brun3e541d12012-09-03 11:14:36 +020038# USE_FUTEX : enable use of futex on kernel 2.6. Automatic.
Willy Tarreau1bc4aab2012-10-08 20:11:03 +020039# USE_ACCEPT4 : enable use of accept4() on linux. Automatic.
Brad Smith5018aac2020-09-30 01:04:48 -040040# USE_CLOSEFROM : enable use of closefrom() on *bsd, solaris. Automatic.
Willy Tarreau636848a2019-04-15 19:38:50 +020041# USE_PRCTL : enable use of prctl(). Automatic.
devnexen@gmail.com078062b2021-08-21 09:13:10 +010042# USE_PROCCTL : enable use of procctl(). Automatic.
Willy Tarreau12840be2021-04-22 14:14:22 +020043# USE_ZLIB : enable zlib library support and disable SLZ
44# USE_SLZ : enable slz library instead of zlib (default=enabled)
Willy Tarreaufc6c0322012-11-16 16:12:27 +010045# USE_CPU_AFFINITY : enable pinning processes to CPU on Linux. Automatic.
Lukas Tribus0999f762013-04-02 16:43:24 +020046# USE_TFO : enable TCP fast open. Supported on Linux >= 3.7.
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +010047# USE_NS : enable network namespace support. Supported on Linux >= 2.6.24.
Willy Tarreau71b99ef2015-03-17 14:33:22 +010048# USE_DL : enable it if your system requires -ldl. Automatic on Linux.
Willy Tarreau58e90cb2018-10-18 16:28:54 +020049# USE_RT : enable it if your system requires -lrt. Automatic on Linux.
Willy Tarreauf5b4e062020-03-03 15:40:23 +010050# USE_BACKTRACE : enable backtrace(). Automatic on Linux.
Willy Tarreau92dc7862021-04-02 15:31:10 +020051# USE_PROMEX : enable the Prometheus exporter
David Carliera03fb142015-06-01 14:00:07 +020052# USE_DEVICEATLAS : enable DeviceAtlas api.
Dragan Dosen93b38d92015-06-29 16:43:25 +020053# USE_51DEGREES : enable third party device detection library from 51Degrees
Willy Tarreaub3cc9f22019-04-19 16:03:32 +020054# USE_WURFL : enable WURFL detection library from Scientiamobile
Tim Duesterhusd6942c82017-11-20 15:58:35 +010055# USE_SYSTEMD : enable sd_notify() support.
Willy Tarreau7b5654f2019-03-29 21:30:17 +010056# USE_OBSOLETE_LINKER : use when the linker fails to emit __start_init/__stop_init
Willy Tarreauc7091d82019-05-17 10:08:49 +020057# USE_THREAD_DUMP : use the more advanced thread state dump system. Automatic.
Miroslav Zagorac70230c62020-12-09 16:54:31 +010058# USE_OT : enable the OpenTracing filter
Willy Tarreauf6818d62021-05-05 18:17:39 +020059# USE_MEMORY_PROFILING : enable the memory profiler. Linux-glibc only.
Willy Tarreaud5d6fdc2021-11-14 15:28:38 +010060# USE_LIBATOMIC : force to link with/without libatomic. Automatic.
Willy Tarreauf2ef8c52007-07-11 09:19:31 +020061#
Willy Tarreau9f2b7302008-01-02 20:48:34 +010062# Options can be forced by specifying "USE_xxx=1" or can be disabled by using
Willy Tarreau50b1aae2019-06-14 15:52:01 +020063# "USE_xxx=" (empty string). The list of enabled and disabled options for a
64# given TARGET is enumerated at the end of "make help".
Willy Tarreau9f2b7302008-01-02 20:48:34 +010065#
66# Variables useful for packagers :
Brad Smith94636432020-09-13 02:53:06 -040067# CC is set to "cc" by default and is used for compilation only.
68# LD is set to "cc" by default and is used for linking only.
Willy Tarreauef7341d2009-04-11 19:45:50 +020069# ARCH may be useful to force build of 32-bit binary on 64-bit systems
Willy Tarreau9f2b7302008-01-02 20:48:34 +010070# CFLAGS is automatically set for the specified CPU and may be overridden.
71# LDFLAGS is automatically set to -g and may be overridden.
Willy Tarreaub26835d2016-05-30 13:39:32 +020072# DEP may be cleared to ignore changes to include files during development
Willy Tarreau9f2b7302008-01-02 20:48:34 +010073# SMALL_OPTS may be used to specify some options to shrink memory usage.
74# DEBUG may be used to set some internal debugging options.
Willy Tarreau23cd43e2018-10-22 06:22:46 +020075# ERR may be set to non-empty to pass -Werror to the compiler
Willy Tarreau9f2b7302008-01-02 20:48:34 +010076# ADDINC may be used to complete the include path in the form -Ipath.
77# ADDLIB may be used to complete the library list in the form -Lpath -llib.
78# DEFINE may be used to specify any additional define, which will be reported
79# by "haproxy -vv" in CFLAGS.
80# SILENT_DEFINE may be used to specify other defines which will not be
81# reported by "haproxy -vv".
William Lallemanda6cfa902017-06-01 17:38:58 +020082# EXTRA is used to force building or not building some extra tools.
Christian Wiesea184aa22008-03-12 15:25:35 +020083# DESTDIR is not set by default and is used for installation only.
84# It might be useful to set DESTDIR if you want to install haproxy
85# in a sandbox.
86# PREFIX is set to "/usr/local" by default and is used for installation only.
87# SBINDIR is set to "$(PREFIX)/sbin" by default and is used for installation
88# only.
Christian Wiese19b50292008-03-12 15:57:54 +020089# MANDIR is set to "$(PREFIX)/share/man" by default and is used for
90# installation only.
Christian Wiesebf34eb42008-03-12 17:24:49 +020091# DOCDIR is set to "$(PREFIX)/doc/haproxy" by default and is used for
92# installation only.
Tim Duesterhus541fe1e2020-01-12 13:55:41 +010093# HLUA_PREPEND_PATH may be used to prepend a folder to Lua's default package.path.
94# HLUA_PREPEND_CPATH may be used to prepend a folder to Lua's default package.cpath.
Willy Tarreau9f2b7302008-01-02 20:48:34 +010095#
96# Other variables :
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +020097# PCRE_CONFIG : force the binary path to get pcre config (by default
98# pcre-config)
Willy Tarreau9f2b7302008-01-02 20:48:34 +010099# PCREDIR : force the path to libpcre.
Willy Tarreau39793092013-02-13 12:39:06 +0100100# PCRE_LIB : force the lib path to libpcre (defaults to $PCREDIR/lib).
101# PCRE_INC : force the include path to libpcre ($PCREDIR/inc)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200102# PCRE2_CONFIG : force the binary path to get pcre2 config (by default
103# pcre2-config)
Willy Tarreau9a059452013-09-17 15:26:39 +0200104# SSL_LIB : force the lib path to libssl/libcrypto
105# SSL_INC : force the include path to libssl/libcrypto
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100106# LUA_LIB : force the lib path to lua
107# LUA_INC : force the include path to lua
Cyril Bontéc21adb52015-03-03 23:13:03 +0100108# LUA_LIB_NAME : force the lib name (or automatically evaluated, by order of
Thierry FOURNIERf90838b2015-03-06 13:48:32 +0100109# priority : lua5.3, lua53, lua).
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100110# OT_DEBUG : compile the OpenTracing filter in debug mode
111# OT_INC : force the include path to libopentracing-c-wrapper
112# OT_LIB : force the lib path to libopentracing-c-wrapper
113# OT_RUNPATH : add RUNPATH for libopentracing-c-wrapper to haproxy executable
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100114# IGNOREGIT : ignore GIT commit versions if set.
115# VERSION : force haproxy version reporting.
116# SUBVERS : add a sub-version (eg: platform, model, ...).
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200117# EXTRAVERSION : local version string to append (e.g. build number etc)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100118# VERDATE : force haproxy's release date.
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200119# VTEST_PROGRAM : location of the vtest program to run reg-tests.
Ilya Shipitsin4a034f22020-09-12 11:24:48 +0500120# DEBUG_USE_ABORT: use abort() for program termination, see include/haproxy/bug.h for details
Willy Tarreau4f60f162007-04-08 16:39:58 +0200121
Willy Tarreaub42233a2018-11-19 07:44:42 +0100122# verbosity: pass V=1 for verbose shell invocation
123V = 0
124Q = @
125ifeq ($V,1)
126Q=
127endif
128
Christopher Faulet16150642021-04-14 14:02:56 +0200129# WARNING: Do not change cc-opt, cc-opt-alt or cc-warning without checking if
130# clang bug #49364 is fixed. stderr is redirected to /dev/null on
131# purpose, to work around a clang 11 bug that crashes if stderr is
132# redirected to stdin.
133#
Willy Tarreaud3a7f402017-09-13 16:54:28 +0200134# Function used to detect support of a given option by the compiler.
135# Usage: CFLAGS += $(call cc-opt,option). Eg: $(call cc-opt,-fwrapv)
136# Note: ensure the referencing variable is assigned using ":=" and not "=" to
137# call it only once.
Christopher Faulet16150642021-04-14 14:02:56 +0200138cc-opt = $(shell set -e; if $(CC) -Werror $(1) -E -xc - -o /dev/null </dev/null >&0 2>/dev/null; then echo "$(1)"; fi;)
Willy Tarreaud3a7f402017-09-13 16:54:28 +0200139
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200140# same but emits $2 if $1 is not supported
Christopher Faulet16150642021-04-14 14:02:56 +0200141cc-opt-alt = $(shell set -e; if $(CC) -Werror $(1) -E -xc - -o /dev/null </dev/null >&0 2>/dev/null; then echo "$(1)"; else echo "$(2)"; fi;)
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200142
Willy Tarreaub7801662017-09-14 19:05:45 +0200143# Disable a warning when supported by the compiler. Don't put spaces around the
144# warning! And don't use cc-opt which doesn't always report an error until
145# another one is also returned.
146# Usage: CFLAGS += $(call cc-nowarn,warning). Eg: $(call cc-opt,format-truncation)
Christopher Faulet16150642021-04-14 14:02:56 +0200147cc-nowarn = $(shell set -e; if $(CC) -Werror -W$(1) -E -xc - -o /dev/null </dev/null >&0 2>/dev/null; then echo "-Wno-$(1)"; fi;)
Willy Tarreaub7801662017-09-14 19:05:45 +0200148
Christian Wiesea184aa22008-03-12 15:25:35 +0200149#### Installation options.
150DESTDIR =
151PREFIX = /usr/local
152SBINDIR = $(PREFIX)/sbin
Jeremy Hinegardneref3b4032008-11-15 17:29:03 -0700153MANDIR = $(PREFIX)/share/man
Christian Wiesebf34eb42008-03-12 17:24:49 +0200154DOCDIR = $(PREFIX)/doc/haproxy
Willy Tarreau4f60f162007-04-08 16:39:58 +0200155
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100156#### TARGET system
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500157# Use TARGET=<target_name> to optimize for a specific target OS among the
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100158# following list (use the default "generic" if uncertain) :
Brad Smith382001b2020-10-08 01:15:06 -0400159# linux-glibc, linux-glibc-legacy, linux-musl, solaris, freebsd, dragonfly,
160# openbsd, netbsd, cygwin, haiku, aix51, aix52, aix72-gcc, osx, generic,
161# custom
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100162TARGET =
Willy Tarreau4f60f162007-04-08 16:39:58 +0200163
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100164#### TARGET CPU
165# Use CPU=<cpu_name> to optimize for a particular CPU, among the following
166# list :
Willy Tarreau40a871f2021-05-12 09:47:30 +0200167# generic, native, i586, i686, ultrasparc, power8, power9, custom,
168# a53, a72, armv81, armv8-auto
willy tarreaueedaa9f2005-12-17 14:08:03 +0100169CPU = generic
willy tarreau036e1ce2005-12-17 13:46:33 +0100170
Willy Tarreauef7341d2009-04-11 19:45:50 +0200171#### Architecture, used when not building for native architecture
172# Use ARCH=<arch_name> to force build for a specific architecture. Known
173# architectures will lead to "-m32" or "-m64" being added to CFLAGS and
174# LDFLAGS. This can be required to build 32-bit binaries on 64-bit targets.
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100175# Currently, only 32, 64, x86_64, i386, i486, i586 and i686 are understood.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200176ARCH =
177
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100178#### Toolchain options.
Brad Smith94636432020-09-13 02:53:06 -0400179CC = cc
Christian Wiesef6308302008-03-17 18:23:12 +0100180LD = $(CC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100181
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100182#### Debug flags (typically "-g").
183# Those flags only feed CFLAGS so it is not mandatory to use this form.
184DEBUG_CFLAGS = -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100185
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200186#### Add -Werror when set to non-empty
187ERR =
188
Willy Tarreaudb863332018-11-23 08:29:15 +0100189#### May be used to force running a specific set of reg-tests
190REG_TEST_FILES =
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +0100191REG_TEST_SCRIPT=./scripts/run-regtests.sh
Willy Tarreaudb863332018-11-23 08:29:15 +0100192
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100193#### Compiler-specific flags that may be used to disable some negative over-
Willy Tarreaud1c847a2020-02-25 10:10:47 +0100194# optimization or to silence some warnings.
Olivier Houchard73bdb322017-04-19 11:34:10 +0200195# We rely on signed integer wraparound on overflow, however clang think it
196# can do whatever it wants since it's an undefined behavior, so use -fwrapv
197# to be sure we get the intended behavior.
Willy Tarreau4b61e692020-03-10 09:37:08 +0100198SPEC_CFLAGS := -Wall -Wextra -Wdeclaration-after-statement
Willy Tarreau0d7a2ae2018-10-16 18:11:34 +0200199SPEC_CFLAGS += $(call cc-opt-alt,-fwrapv,$(call cc-opt,-fno-strict-overflow))
Willy Tarreaub7801662017-09-14 19:05:45 +0200200SPEC_CFLAGS += $(call cc-nowarn,address-of-packed-member)
Willy Tarreaueff9a9e2017-10-27 11:06:11 +0200201SPEC_CFLAGS += $(call cc-nowarn,unused-label)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200202SPEC_CFLAGS += $(call cc-nowarn,sign-compare)
203SPEC_CFLAGS += $(call cc-nowarn,unused-parameter)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200204SPEC_CFLAGS += $(call cc-nowarn,clobbered)
205SPEC_CFLAGS += $(call cc-nowarn,missing-field-initializers)
Olivier Houchard73bce432018-11-27 14:47:58 +0100206SPEC_CFLAGS += $(call cc-nowarn,cast-function-type)
Willy Tarreauc77c2d42019-09-24 09:43:34 +0200207SPEC_CFLAGS += $(call cc-nowarn,string-plus-int)
Willy Tarreaua2701352022-01-07 14:51:56 +0100208SPEC_CFLAGS += $(call cc-nowarn,atomic-alignment)
Willy Tarreauf7db9302018-09-20 10:38:08 +0200209SPEC_CFLAGS += $(call cc-opt,-Wtype-limits)
210SPEC_CFLAGS += $(call cc-opt,-Wshift-negative-value)
211SPEC_CFLAGS += $(call cc-opt,-Wshift-overflow=2)
212SPEC_CFLAGS += $(call cc-opt,-Wduplicated-cond)
213SPEC_CFLAGS += $(call cc-opt,-Wnull-dereference)
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100214
Willy Tarreau4b61e692020-03-10 09:37:08 +0100215ifneq ($(ERR),)
216SPEC_CFLAGS += -Werror
217endif
218
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100219#### Memory usage tuning
220# If small memory footprint is required, you can reduce the buffer size. There
221# are 2 buffers per concurrent session, so 16 kB buffers will eat 32 MB memory
222# with 1000 concurrent sessions. Putting it slightly lower than a page size
223# will prevent the additional parameters to go beyond a page. 8030 bytes is
224# exactly 5.5 TCP segments of 1460 bytes and is generally good. Useful tuning
225# macros include :
226# SYSTEM_MAXCONN, BUFSIZE, MAXREWRITE, REQURI_LEN, CAPTURE_LEN.
227# Example: SMALL_OPTS = -DBUFSIZE=8030 -DMAXREWRITE=1030 -DSYSTEM_MAXCONN=1024
228SMALL_OPTS =
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100229
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100230#### Debug settings
231# You can enable debugging on specific code parts by setting DEBUG=-DDEBUG_xxx.
Willy Tarreau4c442b02020-07-04 12:43:46 +0200232# Use quotes and spaces if multiple options are needed (the DEBUG variables is
233# passed as-is to CFLAGS). Please check sources for their exact meaning or do
234# not use them at all. Some even more obscure ones might also be available
235# without appearing here. Currently defined DEBUG macros include DEBUG_FULL,
236# DEBUG_MEM_STATS, DEBUG_DONT_SHARE_POOLS, DEBUG_NO_LOCKLESS_POOLS, DEBUG_FD,
Willy Tarreau2d6f6282021-04-15 16:24:00 +0200237# DEBUG_NO_POOLS, DEBUG_FAIL_ALLOC, DEBUG_STRICT_NOCRASH, DEBUG_HPACK,
Willy Tarreaub23f0422021-02-16 18:44:00 +0100238# DEBUG_AUTH, DEBUG_SPOE, DEBUG_UAF, DEBUG_THREAD, DEBUG_STRICT, DEBUG_DEV,
William Lallemand60c3b8e2021-09-29 16:03:35 +0200239# DEBUG_TASK, DEBUG_MEMORY_POOLS.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100240DEBUG =
willy tarreau1c2ad212005-12-18 01:11:29 +0100241
Willy Tarreau7de211c2012-05-25 23:53:16 +0200242#### Trace options
243# Use TRACE=1 to trace function calls to file "trace.out" or to stderr if not
244# possible.
245TRACE =
246
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100247#### Additional include and library dirs
248# Redefine this if you want to add some special PATH to include/libs
249ADDINC =
250ADDLIB =
willy tarreau64a3cc32005-12-18 01:13:11 +0100251
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100252#### Specific macro definitions
253# Use DEFINE=-Dxxx to set any tunable macro. Anything declared here will appear
254# in the build options reported by "haproxy -vv". Use SILENT_DEFINE if you do
255# not want to pollute the report with complex defines.
Emeric Brun76d88952012-10-05 15:47:31 +0200256# The following settings might be of interest when SSL is enabled :
257# LISTEN_DEFAULT_CIPHERS is a cipher suite string used to set the default SSL
258# ciphers on "bind" lines instead of using OpenSSL's defaults.
259# CONNECT_DEFAULT_CIPHERS is a cipher suite string used to set the default
260# SSL ciphers on "server" lines instead of using OpenSSL's defaults.
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100261DEFINE =
262SILENT_DEFINE =
willy tarreau0f7af912005-12-17 12:21:26 +0100263
William Lallemanda6cfa902017-06-01 17:38:58 +0200264#### extra programs to build
Willy Tarreaubc289da2014-05-10 12:16:21 +0200265# Force this to enable building extra programs or to disable them.
266# It's automatically appended depending on the targets.
267EXTRA =
willy tarreau5cbea6f2005-12-17 12:48:26 +0100268
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500269#### CPU dependent optimizations
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100270# Some CFLAGS are set by default depending on the target CPU. Those flags only
271# feed CPU_CFLAGS, which in turn feed CFLAGS, so it is not mandatory to use
272# them. You should not have to change these options. Better use CPU_CFLAGS or
273# even CFLAGS instead.
274CPU_CFLAGS.generic = -O2
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100275CPU_CFLAGS.native = -O2 -march=native
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100276CPU_CFLAGS.i586 = -O2 -march=i586
277CPU_CFLAGS.i686 = -O2 -march=i686
278CPU_CFLAGS.ultrasparc = -O6 -mcpu=v9 -mtune=ultrasparc
Christian Lachnerc1322302020-02-10 10:29:13 +0100279CPU_CFLAGS.power8 = -O2 -mcpu=power8 -mtune=power8
280CPU_CFLAGS.power9 = -O2 -mcpu=power9 -mtune=power9
Willy Tarreau40a871f2021-05-12 09:47:30 +0200281CPU_CFLAGS.a53 = -O2 -mcpu=cortex-a53
282CPU_CFLAGS.a72 = -O2 -mcpu=cortex-a72
283CPU_CFLAGS.armv81 = -O2 -march=armv8.1-a
284CPU_CFLAGS.armv8-auto = -O2 -march=armv8-a+crc -moutline-atomics
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100285CPU_CFLAGS = $(CPU_CFLAGS.$(CPU))
willy tarreau9da061b2005-12-17 12:29:56 +0100286
Ilya Shipitsin2a950d02020-03-06 13:07:38 +0500287#### ARCH dependent flags, may be overridden by CPU flags
Willy Tarreaua5899aa2010-11-28 07:41:00 +0100288ARCH_FLAGS.32 = -m32
289ARCH_FLAGS.64 = -m64
Willy Tarreauef7341d2009-04-11 19:45:50 +0200290ARCH_FLAGS.i386 = -m32 -march=i386
291ARCH_FLAGS.i486 = -m32 -march=i486
292ARCH_FLAGS.i586 = -m32 -march=i586
293ARCH_FLAGS.i686 = -m32 -march=i686
294ARCH_FLAGS.x86_64 = -m64 -march=x86-64
295ARCH_FLAGS = $(ARCH_FLAGS.$(ARCH))
296
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100297#### Common CFLAGS
298# These CFLAGS contain general optimization options, CPU-specific optimizations
299# and debug flags. They may be overridden by some distributions which prefer to
300# set all of them at once instead of playing with the CPU and DEBUG variables.
Willy Tarreau3c9a3fb2010-11-28 08:28:15 +0100301CFLAGS = $(ARCH_FLAGS) $(CPU_CFLAGS) $(DEBUG_CFLAGS) $(SPEC_CFLAGS)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100302
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100303#### Common LDFLAGS
304# These LDFLAGS are used as the first "ld" options, regardless of any library
305# path or any other option. They may be changed to add any linker-specific
306# option at the beginning of the ld command line.
Willy Tarreauef7341d2009-04-11 19:45:50 +0200307LDFLAGS = $(ARCH_FLAGS) -g
willy tarreau036e1ce2005-12-17 13:46:33 +0100308
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100309#### list of all "USE_*" options. These ones must be updated if new options are
310# added, so that the relevant options are properly added to the CFLAGS and to
311# the reported build options.
Willy Tarreau06c63ae2020-03-10 07:20:10 +0100312use_opts = USE_EPOLL USE_KQUEUE USE_NETFILTER \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100313 USE_PCRE USE_PCRE_JIT USE_PCRE2 USE_PCRE2_JIT USE_POLL \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100314 USE_PRIVATE_CACHE USE_THREAD USE_PTHREAD_PSHARED USE_BACKTRACE \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100315 USE_STATIC_PCRE USE_STATIC_PCRE2 USE_TPROXY USE_LINUX_TPROXY \
Willy Tarreauc3e926b2020-03-10 06:48:17 +0100316 USE_LINUX_SPLICE USE_LIBCRYPT USE_CRYPT_H \
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100317 USE_GETADDRINFO USE_OPENSSL USE_LUA USE_FUTEX USE_ACCEPT4 \
Brad Smith5018aac2020-09-30 01:04:48 -0400318 USE_CLOSEFROM USE_ZLIB USE_SLZ USE_CPU_AFFINITY USE_TFO USE_NS \
Willy Tarreau14261982019-04-23 10:57:09 +0200319 USE_DL USE_RT USE_DEVICEATLAS USE_51DEGREES USE_WURFL USE_SYSTEMD \
devnexen@gmail.com078062b2021-08-21 09:13:10 +0100320 USE_OBSOLETE_LINKER USE_PRCTL USE_PROCCTL USE_THREAD_DUMP \
321 USE_EVPORTS USE_OT USE_QUIC USE_PROMEX USE_MEMORY_PROFILING
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100322
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100323#### Target system options
324# Depending on the target platform, some options are set, as well as some
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100325# CFLAGS and LDFLAGS. All variables pre-set here will not appear in the build
326# options string. They may be set to any value, but are historically set to
327# "implicit" which eases debugging. You should not have to change anything
328# there unless you're adding support for a new platform.
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100329default_opts = $(foreach name,$(1),$(eval $(name)=implicit))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100330
331# poll() is always supported, unless explicitly disabled by passing USE_POLL=""
332# on the make command line.
Willy Tarreau32e65ef2013-04-02 08:14:29 +0200333USE_POLL = default
334
Willy Tarreau12840be2021-04-22 14:14:22 +0200335# SLZ is always supported unless explicitly disabled by passing USE_SLZ=""
336# or disabled by enabling ZLIB using USE_ZLIB=1
337ifeq ($(USE_ZLIB),)
338USE_SLZ = default
339endif
340
Willy Tarreau39f19922019-03-27 11:44:19 +0100341# generic system target has nothing specific
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100342ifeq ($(TARGET),generic)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100343 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY)
Willy Tarreau39f19922019-03-27 11:44:19 +0100344endif
345
346# Haiku
Jerome Duval38932c32015-10-19 23:01:16 +0000347ifeq ($(TARGET),haiku)
Jerome Duval38932c32015-10-19 23:01:16 +0000348 TARGET_LDFLAGS = -lnetwork
David Carlierb2f06cc2021-06-19 14:42:43 +0000349 set_target_defaults = $(call default_opts,USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Willy Tarreau39f19922019-03-27 11:44:19 +0100350endif
351
Willy Tarreau61cf0dc2019-06-14 16:32:09 +0200352# For linux >= 2.6.28 and glibc
353ifeq ($(TARGET),linux-glibc)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100354 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100355 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
356 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
Willy Tarreau364d6f52019-06-14 18:33:56 +0200357 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100358 USE_GETADDRINFO USE_BACKTRACE)
Willy Tarreau39f19922019-03-27 11:44:19 +0100359endif
360
Lukas Tribuscc1eb162019-09-01 16:48:36 +0200361# For linux >= 2.6.28, glibc without new features
362ifeq ($(TARGET),linux-glibc-legacy)
363 set_target_defaults = $(call default_opts, \
364 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
365 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
366 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_GETADDRINFO)
367endif
368
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200369# For linux >= 2.6.28 and musl
370ifeq ($(TARGET),linux-musl)
371 set_target_defaults = $(call default_opts, \
372 USE_POLL USE_TPROXY USE_LIBCRYPT USE_DL USE_RT USE_CRYPT_H USE_NETFILTER \
373 USE_CPU_AFFINITY USE_THREAD USE_EPOLL USE_FUTEX USE_LINUX_TPROXY \
374 USE_ACCEPT4 USE_LINUX_SPLICE USE_PRCTL USE_THREAD_DUMP USE_NS USE_TFO \
375 USE_GETADDRINFO)
Willy Tarreau39b2fda2020-04-16 15:14:17 +0200376endif
377
Brad Smith7c503bb2020-09-30 15:46:16 -0400378# Solaris 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100379ifeq ($(TARGET),solaris)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100380 set_target_defaults = $(call default_opts, \
Emmanuel Hocdet7093c192019-05-21 09:12:03 +0000381 USE_POLL USE_TPROXY USE_LIBCRYPT USE_CRYPT_H USE_GETADDRINFO USE_THREAD \
Brad Smith7c503bb2020-09-30 15:46:16 -0400382 USE_RT USE_OBSOLETE_LINKER USE_EVPORTS USE_CLOSEFROM)
Emmanuel Hocdet3c0edfa2019-05-17 15:32:21 +0000383 TARGET_CFLAGS = -DFD_SETSIZE=65536 -D_REENTRANT -D_XOPEN_SOURCE=500 -D__EXTENSIONS__
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100384 TARGET_LDFLAGS = -lnsl -lsocket
Willy Tarreau39f19922019-03-27 11:44:19 +0100385endif
386
Brad Smith9d85eb02020-09-15 03:10:04 -0400387# FreeBSD 10 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100388ifeq ($(TARGET),freebsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100389 set_target_defaults = $(call default_opts, \
Willy Tarreauf6bf8e92019-03-27 11:30:47 +0100390 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
devnexen@gmail.com078062b2021-08-21 09:13:10 +0100391 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO USE_PROCCTL)
Willy Tarreau39f19922019-03-27 11:44:19 +0100392endif
393
Brad Smith382001b2020-10-08 01:15:06 -0400394# DragonFlyBSD 4.3 and above
395ifeq ($(TARGET),dragonfly)
396 set_target_defaults = $(call default_opts, \
397 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
398 USE_ACCEPT4 USE_CLOSEFROM USE_GETADDRINFO)
399endif
400
Willy Tarreau39f19922019-03-27 11:44:19 +0100401# Mac OS/X
Willy Tarreau8624cab2013-04-02 08:17:43 +0200402ifeq ($(TARGET),osx)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100403 set_target_defaults = $(call default_opts, \
Brad Smithad5afba2020-10-09 19:26:23 -0400404 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_CPU_AFFINITY USE_KQUEUE \
405 USE_GETADDRINFO)
Willy Tarreaub684e7a2018-03-05 15:37:04 +0100406 EXPORT_SYMBOL = -export_dynamic
Willy Tarreau39f19922019-03-27 11:44:19 +0100407endif
408
Brad Smith90c9d782020-09-26 23:05:25 -0400409# OpenBSD 6.3 and above
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100410ifeq ($(TARGET),openbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100411 set_target_defaults = $(call default_opts, \
Matthieu Guegan496374e2020-11-20 10:50:39 +0100412 USE_POLL USE_TPROXY USE_LIBCRYPT USE_THREAD USE_KQUEUE USE_ACCEPT4 \
413 USE_CLOSEFROM USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100414endif
415
Brad Smith0fdfe412020-10-08 16:24:52 -0400416# NetBSD 8 and above
David Carlierb5714da2015-07-02 06:58:22 +0000417ifeq ($(TARGET),netbsd)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100418 set_target_defaults = $(call default_opts, \
Brad Smith0fdfe412020-10-08 16:24:52 -0400419 USE_POLL USE_TPROXY USE_THREAD USE_KQUEUE USE_ACCEPT4 USE_CLOSEFROM \
420 USE_GETADDRINFO)
Willy Tarreau39f19922019-03-27 11:44:19 +0100421endif
422
423# AIX 5.1 only
Willy Tarreau50abe302014-04-02 20:44:43 +0200424ifeq ($(TARGET),aix51)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100425 set_target_defaults = $(call default_opts, \
Willy Tarreau13d9b022019-03-29 18:56:54 +0100426 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER USE_PRIVATE_CACHE)
Willy Tarreau0aed6ac2019-03-29 18:56:00 +0100427 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 +0200428 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100429endif
430
Christian Lachnerc1322302020-02-10 10:29:13 +0100431# AIX 5.2
Willy Tarreau7dec9652012-06-06 16:15:03 +0200432ifeq ($(TARGET),aix52)
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100433 set_target_defaults = $(call default_opts, \
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100434 USE_POLL USE_LIBCRYPT USE_OBSOLETE_LINKER)
Willy Tarreau7dec9652012-06-06 16:15:03 +0200435 TARGET_CFLAGS = -D_MSGQSUPPORT
436 DEBUG_CFLAGS =
Willy Tarreau39f19922019-03-27 11:44:19 +0100437endif
438
Christian Lachnerc1322302020-02-10 10:29:13 +0100439# AIX 7.2 and above
440ifeq ($(TARGET),aix72-gcc)
441 set_target_defaults = $(call default_opts, \
442 USE_POLL USE_THREAD USE_LIBCRYPT USE_OBSOLETE_LINKER USE_GETADDRINFO)
443 TARGET_CFLAGS = -D_H_XMEM -D_H_VAR
444 TARGET_LDFLAGS = -latomic
445endif
446
Willy Tarreau39f19922019-03-27 11:44:19 +0100447# Cygwin
Yitzhak Sapir32087312009-06-14 18:27:54 +0200448ifeq ($(TARGET),cygwin)
Willy Tarreau7b5654f2019-03-29 21:30:17 +0100449 set_target_defaults = $(call default_opts, \
450 USE_POLL USE_TPROXY USE_OBSOLETE_LINKER)
Thayne McCombs8f0cc5c2021-01-07 21:35:52 -0700451 # Cygwin adds IPv6 support only in version 1.7 (in beta right now).
Yitzhak Sapir32087312009-06-14 18:27:54 +0200452 TARGET_CFLAGS = $(if $(filter 1.5.%, $(shell uname -r)), -DUSE_IPV6 -DAF_INET6=23 -DINET6_ADDRSTRLEN=46, )
Willy Tarreau39f19922019-03-27 11:44:19 +0100453endif
willy tarreau4373b962005-12-18 01:32:31 +0100454
Willy Tarreau57c99ec2019-03-29 20:55:54 +0100455# set the default settings according to the target above
456$(set_target_defaults)
457
Willy Tarreaud5d6fdc2021-11-14 15:28:38 +0100458# Some architectures require to link with libatomic for atomics of certain
459# sizes. These ones are reported as value 1 in the *_LOCK_FREE macros. Value
460# 2 indicates that the builtin is native thus doesn't require libatomic. Hence
461# any occurrence of 1 indicates libatomic is necessary. It's better to avoid
462# linking with it by default as it's not always available nor deployed
463# (especially on archs which do not need it).
464ifneq ($(USE_THREAD),)
465ifneq ($(shell $(CC) $(CFLAGS) -dM -E -xc - </dev/null 2>/dev/null | grep -c 'LOCK_FREE.*1'),0)
466 USE_LIBATOMIC=1
467endif
468endif
469
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100470#### Determine version, sub-version and release date.
471# If GIT is found, and IGNOREGIT is not set, VERSION, SUBVERS and VERDATE are
472# extracted from the last commit. Otherwise, use the contents of the files
473# holding the same names in the current directory.
willy tarreau0174f312005-12-18 01:02:42 +0100474
Willy Tarreau6620dbb2007-01-02 00:44:53 +0100475ifeq ($(IGNOREGIT),)
Willy Tarreau3c55efb2019-06-22 08:24:16 +0200476VERSION := $(shell [ -d .git/. ] && (git describe --tags --match 'v*' --abbrev=0 | cut -c 2-) 2>/dev/null)
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100477ifneq ($(VERSION),)
478# OK git is there and works.
Willy Tarreau30a6f642019-06-22 07:51:02 +0200479SUBVERS := $(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 +0100480VERDATE := $(shell git log -1 --pretty=format:%ci | cut -f1 -d' ' | tr '-' '/')
Willy Tarreauec692562007-09-09 23:31:11 +0200481endif
482endif
483
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100484# Last commit version not found, take it from the files.
Willy Tarreauec692562007-09-09 23:31:11 +0200485ifeq ($(VERSION),)
486VERSION := $(shell cat VERSION 2>/dev/null || touch VERSION)
487endif
488ifeq ($(SUBVERS),)
Willy Tarreau6173bbe2013-12-16 01:34:39 +0100489SUBVERS := $(shell (grep -v '\$$Format' SUBVERS 2>/dev/null || touch SUBVERS) | head -n 1)
Willy Tarreauec692562007-09-09 23:31:11 +0200490endif
491ifeq ($(VERDATE),)
Willy Tarreauf1ed3272014-01-26 00:39:22 +0100492VERDATE := $(shell (grep -v '^\$$Format' VERDATE 2>/dev/null || touch VERDATE) | head -n 1 | cut -f1 -d' ' | tr '-' '/')
Willy Tarreau9bf6c6e2006-12-23 11:12:04 +0100493endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100494
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200495# this one is always empty by default and appended verbatim
496EXTRAVERSION =
497
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100498#### Build options
499# Do not change these ones, enable USE_* variables instead.
500OPTIONS_CFLAGS =
501OPTIONS_LDFLAGS =
502OPTIONS_OBJS =
Willy Tarreau77074d52006-11-12 23:57:19 +0100503
Willy Tarreauada5d092019-01-10 10:01:03 +0100504#### Extra objects to be built and integrated (used only for development)
505EXTRA_OBJS =
506
Willy Tarreau09fe5662019-03-27 10:36:35 +0100507# Return USE_xxx=$(USE_xxx) if the variable was set from the environment or the
508# command line.
509# Usage:
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100510# BUILD_OPTIONS += $(call ignore_implicit,USE_xxx)
Willy Tarreau09fe5662019-03-27 10:36:35 +0100511ignore_implicit = $(if $(subst environment,,$(origin $(1))), \
512 $(if $(subst command line,,$(origin $(1))),, \
513 $(1)=$($(1))), \
514 $(1)=$($(1))) \
Willy Tarreau77074d52006-11-12 23:57:19 +0100515
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100516# This variable collects all USE_* values except those set to "implicit". This
517# is used to report a list of all flags which were used to build this version.
518# Do not assign anything to it.
Willy Tarreau7728ed32019-03-27 13:20:08 +0100519BUILD_OPTIONS := $(foreach opt,$(use_opts),$(call ignore_implicit,$(opt)))
520BUILD_FEATURES := $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),+$(opt),-$(opt)))
Willy Tarreau05fd82d2019-03-27 10:57:49 +0100521
Willy Tarreau824cd002019-03-27 14:44:14 +0100522# All USE_* options have their equivalent macro defined in the code (some might
523# possibly be unused though)
524OPTIONS_CFLAGS += $(foreach opt,$(use_opts),$(if $($(opt)),-D$(opt),))
525
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100526ifneq ($(USE_LIBCRYPT),)
Matthieu Guegan496374e2020-11-20 10:50:39 +0100527ifneq ($(TARGET),openbsd)
David Carlier6c00eba2019-09-01 14:59:10 +0100528ifneq ($(TARGET),osx)
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100529OPTIONS_LDFLAGS += -lcrypt
530endif
David Carlier6c00eba2019-09-01 14:59:10 +0100531endif
Matthieu Guegan496374e2020-11-20 10:50:39 +0100532endif
Krzysztof Piotr Oledzki96105042010-01-29 17:50:44 +0100533
William Lallemand82fe75c2012-10-23 10:25:10 +0200534ifneq ($(USE_ZLIB),)
Willy Tarreaue2f49442012-02-10 20:37:26 +0100535# Use ZLIB_INC and ZLIB_LIB to force path to zlib.h and libz.{a,so} if needed.
536ZLIB_INC =
537ZLIB_LIB =
Willy Tarreau824cd002019-03-27 14:44:14 +0100538OPTIONS_CFLAGS += $(if $(ZLIB_INC),-I$(ZLIB_INC))
Willy Tarreaue2f49442012-02-10 20:37:26 +0100539OPTIONS_LDFLAGS += $(if $(ZLIB_LIB),-L$(ZLIB_LIB)) -lz
William Lallemand82fe75c2012-10-23 10:25:10 +0200540endif
541
Willy Tarreau12840be2021-04-22 14:14:22 +0200542ifneq ($(USE_SLZ),)
543OPTIONS_OBJS += src/slz.o
544endif
545
Willy Tarreau77074d52006-11-12 23:57:19 +0100546ifneq ($(USE_POLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100547OPTIONS_OBJS += src/ev_poll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100548endif
549
550ifneq ($(USE_EPOLL),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100551OPTIONS_OBJS += src/ev_epoll.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100552endif
553
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100554ifneq ($(USE_KQUEUE),)
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100555OPTIONS_OBJS += src/ev_kqueue.o
Willy Tarreau77074d52006-11-12 23:57:19 +0100556endif
557
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000558ifneq ($(USE_EVPORTS),)
Emmanuel Hocdet0ba4f482019-04-08 16:53:32 +0000559OPTIONS_OBJS += src/ev_evports.o
560endif
561
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100562ifneq ($(USE_DL),)
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100563OPTIONS_LDFLAGS += -ldl
564endif
565
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200566ifneq ($(USE_RT),)
Willy Tarreau58e90cb2018-10-18 16:28:54 +0200567OPTIONS_LDFLAGS += -lrt
568endif
569
Willy Tarreauc0bbdc12020-03-04 08:31:47 +0100570ifneq ($(USE_THREAD),)
571OPTIONS_LDFLAGS += -lpthread
572endif
573
Willy Tarreauf5b4e062020-03-03 15:40:23 +0100574ifneq ($(USE_BACKTRACE),)
575OPTIONS_LDFLAGS += -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic)
576endif
577
Amaury Denoyellef75c6402021-04-14 15:03:51 +0200578ifneq ($(USE_CPU_AFFINITY),)
579OPTIONS_OBJS += src/cpuset.o
580endif
581
Emeric Brun7444f012012-05-18 15:48:30 +0200582ifneq ($(USE_OPENSSL),)
Ilya Shipitsinf21023e2020-08-04 15:36:24 +0500583SSL_INC =
584SSL_LIB =
David CARLIER7385f652015-11-06 15:13:06 +0000585# OpenSSL is packaged in various forms and with various dependencies.
Emeric Brun7444f012012-05-18 15:48:30 +0200586# In general -lssl is enough, but on some platforms, -lcrypto may be needed,
Willy Tarreau8f182d92012-09-10 09:11:22 +0200587# reason why it's added by default. Some even need -lz, then you'll need to
Willy Tarreau9a059452013-09-17 15:26:39 +0200588# pass it in the "ADDLIB" variable if needed. If your SSL libraries are not
589# in the usual path, use SSL_INC=/path/to/inc and SSL_LIB=/path/to/lib.
Willy Tarreau824cd002019-03-27 14:44:14 +0100590OPTIONS_CFLAGS += $(if $(SSL_INC),-I$(SSL_INC))
Willy Tarreaucd360ce2014-10-31 07:36:51 +0100591OPTIONS_LDFLAGS += $(if $(SSL_LIB),-L$(SSL_LIB)) -lssl -lcrypto
Dirkjan Bussink1866d6d2016-08-29 13:26:37 +0200592ifneq ($(USE_DL),)
593OPTIONS_LDFLAGS += -ldl
594endif
William Lallemand6a66a5e2020-05-15 12:01:17 +0200595OPTIONS_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 +0100596endif
Frédéric Lécailleb83b0102020-11-23 15:53:17 +0100597ifneq ($(USE_QUIC),)
598OPTIONS_OBJS += src/quic_sock.o src/proto_quic.o src/xprt_quic.o src/quic_tls.o \
599 src/quic_frame.o src/quic_cc.o src/quic_cc_newreno.o
600endif
William Lallemandb620e982017-11-02 16:00:51 +0100601
602# The private cache option affect the way the shctx is built
Willy Tarreau824cd002019-03-27 14:44:14 +0100603ifeq ($(USE_PRIVATE_CACHE),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200604ifneq ($(USE_PTHREAD_PSHARED),)
Emeric Bruncd1a5262014-05-07 23:11:42 +0200605OPTIONS_LDFLAGS += -lpthread
Emeric Bruncd1a5262014-05-07 23:11:42 +0200606endif
Emeric Brun3e541d12012-09-03 11:14:36 +0200607endif
Olivier Houchard2292edf2019-02-25 14:26:54 +0100608
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100609ifneq ($(USE_LUA),)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100610check_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 +0800611check_lua_inc = $(shell if [ -d $(2)$(1) ]; then echo $(2)$(1); fi;)
Cyril Bontéc21adb52015-03-03 23:13:03 +0100612
Willy Tarreau824cd002019-03-27 14:44:14 +0100613OPTIONS_CFLAGS += $(if $(LUA_INC),-I$(LUA_INC))
Thierry Fournier13113d62018-02-26 09:25:56 +0100614LUA_LD_FLAGS := -Wl,$(if $(EXPORT_SYMBOL),$(EXPORT_SYMBOL),--export-dynamic) $(if $(LUA_LIB),-L$(LUA_LIB))
Cyril Bontéc21adb52015-03-03 23:13:03 +0100615ifeq ($(LUA_LIB_NAME),)
616# Try to automatically detect the Lua library
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100617LUA_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 +0100618ifeq ($(LUA_LIB_NAME),)
Thierry FOURNIER463119c2015-03-10 00:35:36 +0100619$(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 +0100620endif
Nan Liub286fff2017-06-09 15:57:45 +0800621LUA_INC := $(firstword $(foreach lib,lua5.3 lua53 lua,$(call check_lua_inc,$(lib),"/usr/include/")))
622ifneq ($(LUA_INC),)
623OPTIONS_CFLAGS += -I$(LUA_INC)
624endif
Tim Duesterhus541fe1e2020-01-12 13:55:41 +0100625ifneq ($(HLUA_PREPEND_PATH),)
626OPTIONS_CFLAGS += -DHLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
627BUILD_OPTIONS += HLUA_PREPEND_PATH=$(HLUA_PREPEND_PATH)
628endif
629ifneq ($(HLUA_PREPEND_CPATH),)
630OPTIONS_CFLAGS += -DHLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
631BUILD_OPTIONS += HLUA_PREPEND_CPATH=$(HLUA_PREPEND_CPATH)
632endif
Cyril Bontéc21adb52015-03-03 23:13:03 +0100633endif
634
Willy Tarreau71b99ef2015-03-17 14:33:22 +0100635OPTIONS_LDFLAGS += $(LUA_LD_FLAGS) -l$(LUA_LIB_NAME) -lm
Vincent Bernate192cbb2015-07-16 20:52:51 +0200636ifneq ($(USE_DL),)
637OPTIONS_LDFLAGS += -ldl
638endif
Thierry Fournierfb0b5462016-01-21 09:28:58 +0100639OPTIONS_OBJS += src/hlua.o src/hlua_fcn.o
Thierry FOURNIER6f1fd482015-01-23 14:06:13 +0100640endif
641
Willy Tarreau92dc7862021-04-02 15:31:10 +0200642ifneq ($(USE_PROMEX),)
Willy Tarreau3dfadc72021-04-02 15:35:19 +0200643OPTIONS_OBJS += addons/promex/service-prometheus.o
Willy Tarreau92dc7862021-04-02 15:31:10 +0200644endif
645
David Carliera03fb142015-06-01 14:00:07 +0200646ifneq ($(USE_DEVICEATLAS),)
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200647# Use DEVICEATLAS_SRC and possibly DEVICEATLAS_INC and DEVICEATLAS_LIB to force path
Dragan Dosen93b38d92015-06-29 16:43:25 +0200648# to DeviceAtlas headers and libraries if needed.
Willy Tarreau82bd42e2015-06-02 14:10:28 +0200649DEVICEATLAS_SRC =
650DEVICEATLAS_INC = $(DEVICEATLAS_SRC)
651DEVICEATLAS_LIB = $(DEVICEATLAS_SRC)
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100652ifeq ($(DEVICEATLAS_SRC),)
653OPTIONS_LDFLAGS += -lda
654else
David Carlier019dbd72021-02-16 11:37:45 +0000655ifeq ($(USE_PCRE),)
656ifeq ($(USE_PCRE2),)
657$(error the DeviceAtlas module needs the PCRE or the PCRE2 library in order to compile)
658endif
659endif
660ifneq ($(USE_PCRE2),)
661OPTIONS_CFLAGS += -DDA_REGEX_HDR=\"dac_pcre2.c\" -DDA_REGEX_TAG=2
662endif
David Carliera03fb142015-06-01 14:00:07 +0200663OPTIONS_OBJS += $(DEVICEATLAS_LIB)/json.o
664OPTIONS_OBJS += $(DEVICEATLAS_LIB)/dac.o
Bertrand Jacquin3a2661d2016-10-06 00:32:39 +0100665endif
Willy Tarreauf8d9ec52021-04-02 16:19:39 +0200666OPTIONS_OBJS += addons/deviceatlas/da.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100667OPTIONS_CFLAGS += $(if $(DEVICEATLAS_INC),-I$(DEVICEATLAS_INC))
David Carliera03fb142015-06-01 14:00:07 +0200668endif
669
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100670ifneq ($(USE_51DEGREES),)
Willy Tarreauc7203c72015-06-01 11:12:35 +0200671# Use 51DEGREES_SRC and possibly 51DEGREES_INC and 51DEGREES_LIB to force path
672# to 51degrees headers and libraries if needed.
67351DEGREES_SRC =
67451DEGREES_INC = $(51DEGREES_SRC)
67551DEGREES_LIB = $(51DEGREES_SRC)
James Rosewell3670eb12015-09-18 17:24:29 +0100676OPTIONS_OBJS += $(51DEGREES_LIB)/../cityhash/city.o
Dragan Dosen93b38d92015-06-29 16:43:25 +0200677OPTIONS_OBJS += $(51DEGREES_LIB)/51Degrees.o
Willy Tarreau977209d2021-04-02 16:12:32 +0200678OPTIONS_OBJS += addons/51degrees/51d.o
Willy Tarreau824cd002019-03-27 14:44:14 +0100679OPTIONS_CFLAGS += $(if $(51DEGREES_INC),-I$(51DEGREES_INC))
Ben51Degrees4ddf59d2019-02-05 13:24:00 +0000680ifeq ($(USE_THREAD),)
681OPTIONS_CFLAGS += -DFIFTYONEDEGREES_NO_THREADING
682else
683OPTIONS_OBJS += $(51DEGREES_LIB)/../threading.o
684endif
685
James Rosewell3670eb12015-09-18 17:24:29 +0100686OPTIONS_LDFLAGS += $(if $(51DEGREES_LIB),-L$(51DEGREES_LIB)) -lm
Thomas Holmes0ca65f82015-05-12 15:06:21 +0100687endif
688
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200689ifneq ($(USE_WURFL),)
690# Use WURFL_SRC and possibly WURFL_INC and WURFL_LIB to force path
691# to WURFL headers and libraries if needed.
692WURFL_SRC =
693WURFL_INC = $(WURFL_SRC)
694WURFL_LIB = $(WURFL_SRC)
Willy Tarreau57610c62021-04-02 16:39:44 +0200695OPTIONS_OBJS += addons/wurfl/wurfl.o
Willy Tarreau14261982019-04-23 10:57:09 +0200696OPTIONS_CFLAGS += $(if $(WURFL_INC),-I$(WURFL_INC))
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200697ifneq ($(WURFL_DEBUG),)
698OPTIONS_CFLAGS += -DWURFL_DEBUG
699endif
700ifneq ($(WURFL_HEADER_WITH_DETAILS),)
701OPTIONS_CFLAGS += -DWURFL_HEADER_WITH_DETAILS
702endif
Willy Tarreaub3cc9f22019-04-19 16:03:32 +0200703OPTIONS_LDFLAGS += $(if $(WURFL_LIB),-L$(WURFL_LIB)) -lwurfl
704endif
705
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100706ifneq ($(USE_SYSTEMD),)
Tim Duesterhusd6942c82017-11-20 15:58:35 +0100707OPTIONS_LDFLAGS += -lsystemd
708endif
709
Hiroaki Nakamura70351322013-01-13 15:00:42 +0900710ifneq ($(USE_PCRE)$(USE_STATIC_PCRE)$(USE_PCRE_JIT),)
David Carlierf2592b22016-11-21 21:25:58 +0000711ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
712$(error cannot compile both PCRE and PCRE2 support)
713endif
Willy Tarreau39793092013-02-13 12:39:06 +0100714# PCREDIR is used to automatically construct the PCRE_INC and PCRE_LIB paths,
715# by appending /include and /lib respectively. If your system does not use the
716# same sub-directories, simply force these variables instead of PCREDIR. It is
717# automatically detected but can be forced if required (for cross-compiling).
718# Forcing PCREDIR to an empty string will let the compiler use the default
719# locations.
720
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200721PCRE_CONFIG := pcre-config
722PCREDIR := $(shell $(PCRE_CONFIG) --prefix 2>/dev/null || echo /usr/local)
Willy Tarreau39793092013-02-13 12:39:06 +0100723ifneq ($(PCREDIR),)
724PCRE_INC := $(PCREDIR)/include
725PCRE_LIB := $(PCREDIR)/lib
Willy Tarreau79b34bf2006-12-22 15:28:43 +0100726endif
Willy Tarreau39793092013-02-13 12:39:06 +0100727
Christian Wiesec8203002008-11-20 14:47:04 +0100728ifeq ($(USE_STATIC_PCRE),)
Willy Tarreau39793092013-02-13 12:39:06 +0100729# dynamic PCRE
730OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
731OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -lpcreposix -lpcre
Willy Tarreau39793092013-02-13 12:39:06 +0100732else
733# static PCRE
734OPTIONS_CFLAGS += -DUSE_PCRE $(if $(PCRE_INC),-I$(PCRE_INC))
735OPTIONS_LDFLAGS += $(if $(PCRE_LIB),-L$(PCRE_LIB)) -Wl,-Bstatic -lpcreposix -lpcre -Wl,-Bdynamic
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100736endif
Willy Tarreau39793092013-02-13 12:39:06 +0100737endif
Willy Tarreau77074d52006-11-12 23:57:19 +0100738
David Carlierf2592b22016-11-21 21:25:58 +0000739ifneq ($(USE_PCRE2)$(USE_STATIC_PCRE2)$(USE_PCRE2_JIT),)
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200740PCRE2_CONFIG := pcre2-config
741PCRE2DIR := $(shell $(PCRE2_CONFIG) --prefix 2>/dev/null || echo /usr/local)
David Carlierf2592b22016-11-21 21:25:58 +0000742ifneq ($(PCRE2DIR),)
743PCRE2_INC := $(PCRE2DIR)/include
744PCRE2_LIB := $(PCRE2DIR)/lib
745
746ifeq ($(PCRE2_WIDTH),)
747PCRE2_WIDTH = 8
748endif
749
750ifneq ($(PCRE2_WIDTH),8)
751ifneq ($(PCRE2_WIDTH),16)
752ifneq ($(PCRE2_WIDTH),32)
753$(error PCRE2_WIDTH needs to be set to either 8,16 or 32)
754endif
755endif
756endif
757
758
Fabrice Fontaine7b4c8c32018-09-28 19:21:26 +0200759PCRE2_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 +0000760
761ifeq ($(PCRE2_LDFLAGS),)
762$(error libpcre2-$(PCRE2_WIDTH) not found)
763else
764ifeq ($(PCRE2_WIDTH),8)
765PCRE2_LDFLAGS += -lpcre2-posix
766endif
767endif
768
769OPTIONS_CFLAGS += -DUSE_PCRE2 -DPCRE2_CODE_UNIT_WIDTH=$(PCRE2_WIDTH)
770OPTIONS_CFLAGS += $(if $(PCRE2_INC), -I$(PCRE2_INC))
771
772ifneq ($(USE_STATIC_PCRE2),)
773OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -Wl,-Bstatic -L$(PCRE2_LIB) $(PCRE2_LDFLAGS) -Wl,-Bdynamic
David Carlierf2592b22016-11-21 21:25:58 +0000774else
775OPTIONS_LDFLAGS += $(if $(PCRE2_LIB),-L$(PCRE2_LIB)) -L$(PCRE2_LIB) $(PCRE2_LDFLAGS)
David Carlierf2592b22016-11-21 21:25:58 +0000776endif
777
David Carlierf2592b22016-11-21 21:25:58 +0000778endif
779endif
780
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100781#### Global compile options
782VERBOSE_CFLAGS = $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE)
Willy Tarreaufc80e302020-05-27 11:05:33 +0200783COPTS = -Iinclude
Willy Tarreau23cd43e2018-10-22 06:22:46 +0200784
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100785COPTS += $(CFLAGS) $(TARGET_CFLAGS) $(SMALL_OPTS) $(DEFINE) $(SILENT_DEFINE)
786COPTS += $(DEBUG) $(OPTIONS_CFLAGS) $(ADDINC)
willy tarreaueedaa9f2005-12-17 14:08:03 +0100787
Willy Tarreauac32b4b2020-10-01 04:05:39 +0200788ifneq ($(VERSION)$(SUBVERS)$(EXTRAVERSION),)
789COPTS += -DCONFIG_HAPROXY_VERSION=\"$(VERSION)$(SUBVERS)$(EXTRAVERSION)\"
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100790endif
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100791
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100792ifneq ($(VERDATE),)
793COPTS += -DCONFIG_HAPROXY_DATE=\"$(VERDATE)\"
Willy Tarreau6d1a9882007-01-07 02:03:04 +0100794endif
795
Willy Tarreau7de211c2012-05-25 23:53:16 +0200796ifneq ($(TRACE),)
797# if tracing is enabled, we want it to be as fast as possible
798TRACE_COPTS := $(filter-out -O0 -O1 -O2 -pg -finstrument-functions,$(COPTS)) -O3 -fomit-frame-pointer
799COPTS += -finstrument-functions
800endif
801
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100802ifneq ($(USE_NS),)
Willy Tarreau7520e4f2018-11-11 14:38:09 +0100803OPTIONS_OBJS += src/namespace.o
KOVACS Krisztianb3e54fe2014-11-17 15:11:45 +0100804endif
805
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100806ifneq ($(USE_OT),)
Willy Tarreaua63d1a02021-04-02 17:16:46 +0200807include addons/ot/Makefile
Miroslav Zagorac70230c62020-12-09 16:54:31 +0100808endif
809
Willy Tarreaud5d6fdc2021-11-14 15:28:38 +0100810ifneq ($(USE_LIBATOMIC),)
811 TARGET_LDFLAGS += -latomic
812endif
813
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100814#### Global link options
815# These options are added at the end of the "ld" command line. Use LDFLAGS to
816# add options at the beginning of the "ld" command line if needed.
817LDOPTS = $(TARGET_LDFLAGS) $(OPTIONS_LDFLAGS) $(ADDLIB)
willy tarreau0f7af912005-12-17 12:21:26 +0100818
Willy Tarreau16119652018-11-19 08:15:54 +0100819ifeq ($V,1)
820cmd_CC = $(CC)
821cmd_LD = $(LD)
822cmd_AR = $(AR)
823else
824cmd_CC = $(Q)echo " CC $@";$(CC)
825cmd_LD = $(Q)echo " LD $@";$(LD)
826cmd_AR = $(Q)echo " AR $@";$(AR)
827endif
828
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100829ifeq ($(TARGET),)
830all:
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100831 @echo "Building HAProxy without specifying a TARGET is not supported."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100832 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100833 @echo "Usage:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100834 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100835 @echo " $ make help # To print a full explanation."
836 @echo " $ make TARGET=xxx USE_<feature>=1 # To build HAProxy."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100837 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100838 @echo "The most commonly used targets are:"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100839 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100840 @echo " linux-glibc - Modern Linux with glibc"
841 @echo " linux-musl - Modern Linux with musl"
842 @echo " freebsd - FreeBSD"
843 @echo " openbsd - OpenBSD"
844 @echo " netbsd - NetBSD"
845 @echo " osx - macOS"
846 @echo " solaris - Solaris"
847 @echo
848 @echo "Choose the target which matches your OS the most in order to"
849 @echo "gain the maximum performance out of it."
850 @echo
851 @echo "Common features you might want to include in your build are:"
852 @echo
853 @echo " USE_OPENSSL=1 - Support for TLS encrypted connections"
854 @echo " USE_ZLIB=1 - Support for HTTP response compression"
855 @echo " USE_PCRE=1 - Support for PCRE regular expressions"
856 @echo " USE_LUA=1 - Support for dynamic processing using Lua"
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100857 @echo
Tim Duesterhus1ab76dd2021-01-05 18:10:41 +0100858 @echo "Use 'make help' to print a full explanation of supported targets"
859 @echo "and features."
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100860 @echo
861 @exit 1
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200862else
863ifneq ($(filter $(TARGET), linux linux22 linux24 linux24e linux26 linux2628),)
Willy Tarreau99e49e92019-06-14 16:44:49 +0200864all:
865 @echo
866 @echo "Target '$(TARGET)' was removed from HAProxy 2.0 due to being irrelevant and"
867 @echo "often wrong. Please use 'linux-glibc' instead or define your custom target"
868 @echo "by checking available options using 'make help TARGET=<your-target>'."
869 @echo
870 @exit 1
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100871else
Willy Tarreau888bda02021-04-02 13:59:17 +0200872all: haproxy dev/flags/flags $(EXTRA)
Willy Tarreaue4208cb2008-03-11 06:37:39 +0100873endif
Willy Tarreauc31e5a52019-06-16 17:53:39 +0200874endif
willy tarreau0f7af912005-12-17 12:21:26 +0100875
Willy Tarreau2404e372020-11-05 16:42:25 +0100876OBJS =
Willy Tarreau7de211c2012-05-25 23:53:16 +0200877
Willy Tarreauada5d092019-01-10 10:01:03 +0100878ifneq ($(EXTRA_OBJS),)
879OBJS += $(EXTRA_OBJS)
880endif
Marc-Antoine Perennoued9803e2013-02-12 10:53:53 +0100881
Willy Tarreau1d142622021-05-08 23:33:25 +0200882OBJS += src/mux_h2.o src/mux_fcgi.o src/http_ana.o src/mux_h1.o src/stream.o \
883 src/tcpcheck.o src/stats.o src/flt_spoe.o src/server.o src/tools.o \
884 src/sample.o src/log.o src/backend.o src/stick_table.o src/cfgparse.o \
885 src/peers.o src/cli.o src/pattern.o src/resolvers.o src/proxy.o \
886 src/http_htx.o src/check.o src/cache.o src/cfgparse-listen.o \
887 src/haproxy.o src/http_act.o src/stream_interface.o src/http_fetch.o \
888 src/listener.o src/dns.o src/connection.o src/tcp_rules.o src/debug.o \
889 src/sink.o src/payload.o src/mux_pt.o src/filters.o src/fcgi-app.o \
890 src/server_state.o src/vars.o src/map.o src/cfgparse-global.o \
891 src/task.o src/flt_http_comp.o src/session.o src/sock.o \
892 src/flt_trace.o src/acl.o src/trace.o src/http_rules.o src/queue.o \
893 src/mjson.o src/h2.o src/h1.o src/mworker.o src/lb_chash.o src/ring.o \
894 src/activity.o src/tcp_sample.o src/proto_tcp.o src/htx.o src/h1_htx.o \
895 src/extcheck.o src/channel.o src/proto_sockpair.o src/fd.o \
896 src/compression.o src/mqtt.o src/tcp_act.o src/raw_sock.o \
897 src/frontend.o src/http_conv.o src/xprt_handshake.o src/pool.o \
898 src/applet.o src/mailers.o src/lb_fwrr.o src/lb_fwlc.o src/lb_fas.o \
899 src/proto_uxst.o src/http.o src/action.o src/protocol.o src/thread.o \
900 src/sock_unix.o src/proto_udp.o src/lb_map.o src/sock_inet.o src/lru.o \
901 src/cfgparse-tcp.o src/cfgdiag.o src/proto_uxdg.o src/ev_select.o \
902 src/cfgparse-unix.o src/uri_normalizer.o src/ebmbtree.o src/sha1.o \
903 src/time.o src/signal.o src/mworker-prog.o src/hpack-dec.o src/fix.o \
904 src/arg.o src/eb64tree.o src/chunk.o src/shctx.o src/regex.o \
905 src/fcgi.o src/eb32tree.o src/eb32sctree.o src/dynbuf.o src/uri_auth.o \
906 src/hpack-tbl.o src/ebimtree.o src/auth.o src/ebsttree.o \
907 src/ebistree.o src/base64.o src/wdt.o src/pipe.o src/http_acl.o \
908 src/hpack-enc.o src/dict.o src/dgram.o src/init.o src/hpack-huff.o \
909 src/freq_ctr.o src/ebtree.o src/hash.o src/version.o
Willy Tarreau2404e372020-11-05 16:42:25 +0100910
911ifneq ($(TRACE),)
912OBJS += src/calltrace.o
913endif
914
Willy Tarreaub26835d2016-05-30 13:39:32 +0200915# Used only for forced dependency checking. May be cleared during development.
Willy Tarreaufc80e302020-05-27 11:05:33 +0200916INCLUDES = $(wildcard include/*/*.h)
Willy Tarreau8225bb42016-05-30 15:16:10 +0200917DEP = $(INCLUDES) .build_opts
918
William Lallemandf1b60f72018-12-13 14:02:25 +0100919help:
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000920 @sed -ne "/^[^#]*$$/q;s/^# \{0,1\}\(.*\)/\1/;p" Makefile
921 @echo; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200922 if [ -n "$(TARGET)" ]; then \
Willy Tarreau5fb76032019-06-16 19:26:18 +0200923 if [ -n "$(set_target_defaults)" ]; then \
924 echo "Current TARGET: $(TARGET)"; \
925 else \
926 echo "Current TARGET: $(TARGET) (custom target)"; \
927 fi; \
Willy Tarreau50b1aae2019-06-14 15:52:01 +0200928 else \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200929 echo "TARGET not set, you may pass 'TARGET=xxx' to set one among :";\
Brad Smith382001b2020-10-08 01:15:06 -0400930 echo " linux-glibc, linux-glibc-legacy, solaris, freebsd, dragonfly, netbsd,"; \
931 echo " osx, openbsd, aix51, aix52, aix72-gcc, cygwin, haiku, generic,"; \
932 echo " custom"; \
Willy Tarreau648fa9d2019-06-14 15:52:01 +0200933 fi
Bertrand Jacquinb399a992021-01-17 18:47:47 +0000934 @echo;echo "Enabled features for TARGET '$(TARGET)' (disable with 'USE_xxx=') :"
935 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),$(opt),)); echo " $$*" | (fmt || cat) 2>/dev/null
936 @echo;echo "Disabled features for TARGET '$(TARGET)' (enable with 'USE_xxx=1') :"
937 @set -- $(foreach opt,$(patsubst USE_%,%,$(use_opts)),$(if $(USE_$(opt)),,$(opt))); echo " $$*" | (fmt || cat) 2>/dev/null
William Lallemandf1b60f72018-12-13 14:02:25 +0100938
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100939# Used only to force a rebuild if some build options change, but we don't do
940# it for certain targets which take no build options
941ifneq (reg-tests, $(firstword $(MAKECMDGOALS)))
Tim Duesterhus81e948e2020-11-21 18:07:58 +0100942build_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 +0100943.build_opts: $(build_opts)
Willy Tarreau6f6d96d2020-03-04 16:21:06 +0100944else
945.build_opts:
946endif
Willy Tarreaub26835d2016-05-30 13:39:32 +0200947
Willy Tarreauff0e8a42020-05-27 10:43:24 +0200948haproxy: $(OPTIONS_OBJS) $(OBJS)
Willy Tarreau16119652018-11-19 08:15:54 +0100949 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
willy tarreau0f7af912005-12-17 12:21:26 +0100950
Willy Tarreaubaaee002006-06-26 02:48:02 +0200951objsize: haproxy
Willy Tarreaub42233a2018-11-19 07:44:42 +0100952 $(Q)objdump -t $^|grep ' g '|grep -F '.text'|awk '{print $$5 FS $$6}'|sort
Willy Tarreaubaaee002006-06-26 02:48:02 +0200953
Willy Tarreaub26835d2016-05-30 13:39:32 +0200954%.o: %.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100955 $(cmd_CC) $(COPTS) -c -o $@ $<
willy tarreau0f7af912005-12-17 12:21:26 +0100956
Willy Tarreaua9f16c62021-04-02 14:46:21 +0200957admin/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
958 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200959
Willy Tarreau8f72d482021-08-11 13:54:52 +0200960admin/dyncookie/dyncookie: admin/dyncookie/dyncookie.o
961 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
962
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200963dev/flags/flags: dev/flags/flags.o
964 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
Willy Tarreau5c643f32020-10-22 05:12:57 +0200965
Willy Tarreau21ef8b92021-04-02 14:27:26 +0200966dev/hpack/%: dev/hpack/%.o
967 $(cmd_LD) $(LDFLAGS) -o $@ $^ $(LDOPTS)
968
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200969dev/poll/poll:
970 $(Q)$(MAKE) -C dev/poll poll CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200971
Willy Tarreau074ebcd2021-04-02 13:31:46 +0200972dev/tcploop/tcploop:
973 $(Q)$(MAKE) -C dev/tcploop tcploop CC='$(cmd_CC)' OPTIMIZE='$(COPTS)'
Willy Tarreau5c643f32020-10-22 05:12:57 +0200974
Willy Tarreau909b9d82019-01-04 18:20:32 +0100975# rebuild it every time
976.PHONY: src/version.c
977
Willy Tarreau9eebd8a2019-08-08 16:53:40 +0200978src/calltrace.o: src/calltrace.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100979 $(cmd_CC) $(TRACE_COPTS) -c -o $@ $<
Willy Tarreau7de211c2012-05-25 23:53:16 +0200980
Willy Tarreaub26835d2016-05-30 13:39:32 +0200981src/haproxy.o: src/haproxy.c $(DEP)
Willy Tarreau16119652018-11-19 08:15:54 +0100982 $(cmd_CC) $(COPTS) \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100983 -DBUILD_TARGET='"$(strip $(TARGET))"' \
Willy Tarreauef7341d2009-04-11 19:45:50 +0200984 -DBUILD_ARCH='"$(strip $(ARCH))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100985 -DBUILD_CPU='"$(strip $(CPU))"' \
986 -DBUILD_CC='"$(strip $(CC))"' \
987 -DBUILD_CFLAGS='"$(strip $(VERBOSE_CFLAGS))"' \
988 -DBUILD_OPTIONS='"$(strip $(BUILD_OPTIONS))"' \
Tim Duesterhusc8d19702020-11-21 18:07:59 +0100989 -DBUILD_DEBUG='"$(strip $(DEBUG))"' \
Willy Tarreau7728ed32019-03-27 13:20:08 +0100990 -DBUILD_FEATURES='"$(strip $(BUILD_FEATURES))"' \
Willy Tarreau9f2b7302008-01-02 20:48:34 +0100991 -c -o $@ $<
Willy Tarreau7b066db2007-12-02 11:28:59 +0100992
Christian Wiese19b50292008-03-12 15:57:54 +0200993install-man:
Willy Tarreau4ab5d032018-11-19 07:51:04 +0100994 $(Q)install -v -d "$(DESTDIR)$(MANDIR)"/man1
995 $(Q)install -v -m 644 doc/haproxy.1 "$(DESTDIR)$(MANDIR)"/man1
Christian Wiese19b50292008-03-12 15:57:54 +0200996
Vincent Bernat5c5147f2015-10-13 22:20:55 +0200997EXCLUDE_DOCUMENTATION = lgpl gpl coding-style
998DOCUMENTATION = $(filter-out $(EXCLUDE_DOCUMENTATION),$(patsubst doc/%.txt,%,$(wildcard doc/*.txt)))
999
Christian Wiesebf34eb42008-03-12 17:24:49 +02001000install-doc:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001001 $(Q)install -v -d "$(DESTDIR)$(DOCDIR)"
1002 $(Q)for x in $(DOCUMENTATION); do \
1003 install -v -m 644 doc/$$x.txt "$(DESTDIR)$(DOCDIR)" ; \
Christian Wiesebf34eb42008-03-12 17:24:49 +02001004 done
1005
Willy Tarreau13d67bb2016-06-24 18:30:22 +02001006install-bin:
Willy Tarreaub42233a2018-11-19 07:44:42 +01001007 $(Q)for i in haproxy $(EXTRA); do \
Willy Tarreau13d67bb2016-06-24 18:30:22 +02001008 if ! [ -e "$$i" ]; then \
1009 echo "Please run 'make' before 'make install'."; \
1010 exit 1; \
1011 fi; \
1012 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001013 $(Q)install -v -d "$(DESTDIR)$(SBINDIR)"
1014 $(Q)install -v haproxy $(EXTRA) "$(DESTDIR)$(SBINDIR)"
Christian Wiesea184aa22008-03-12 15:25:35 +02001015
Christian Wiesedb5238d2008-03-12 18:28:13 +02001016install: install-bin install-man install-doc
Christian Wiese4cf5d572008-03-12 16:21:05 +02001017
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001018uninstall:
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001019 $(Q)rm -f "$(DESTDIR)$(MANDIR)"/man1/haproxy.1
1020 $(Q)for x in $(DOCUMENTATION); do \
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001021 rm -f "$(DESTDIR)$(DOCDIR)"/$$x.txt ; \
1022 done
Willy Tarreau4ab5d032018-11-19 07:51:04 +01001023 $(Q)-rmdir "$(DESTDIR)$(DOCDIR)"
1024 $(Q)rm -f "$(DESTDIR)$(SBINDIR)"/haproxy
Ilyas Bakirovdfb124f2015-02-04 17:14:26 +06001025
willy tarreau0f7af912005-12-17 12:21:26 +01001026clean:
Willy Tarreauff0e8a42020-05-27 10:43:24 +02001027 $(Q)rm -f *.[oas] src/*.[oas] haproxy test .build_opts .build_opts.new
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001028 $(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 +02001029 $(Q)rm -f haproxy-$(VERSION).tar.gz haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1030 $(Q)rm -f haproxy-$(VERSION) haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) nohup.out gmon.out
Willy Tarreau3dfadc72021-04-02 15:35:19 +02001031 $(Q)rm -f addons/promex/*.[oas]
Willy Tarreau977209d2021-04-02 16:12:32 +02001032 $(Q)rm -f addons/51degrees/*.[oas] addons/51degrees/dummy/*.[oas] addons/51degrees/dummy/*/*.[oas]
Willy Tarreauf8d9ec52021-04-02 16:19:39 +02001033 $(Q)rm -f addons/deviceatlas/*.[oas] addons/deviceatlas/dummy/*.[oas]
Willy Tarreaua63d1a02021-04-02 17:16:46 +02001034 $(Q)rm -f addons/ot/src/*.[oas]
Willy Tarreau57610c62021-04-02 16:39:44 +02001035 $(Q)rm -f addons/wurfl/*.[oas] addons/wurfl/dummy/*.[oas]
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001036 $(Q)rm -f admin/*/*.[oas] admin/*/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001037 $(Q)rm -f admin/iprange/iprange admin/iprange/ip6range admin/halog/halog
Willy Tarreau8f72d482021-08-11 13:54:52 +02001038 $(Q)rm -f admin/dyncookie/dyncookie
Willy Tarreauaf6ae632021-04-21 17:17:16 +02001039 $(Q)rm -f dev/*/*.[oas]
Willy Tarreaud7988892021-04-02 14:45:06 +02001040 $(Q)rm -f dev/flags/flags dev/poll/poll dev/tcploop/tcploop
Willy Tarreau21ef8b92021-04-02 14:27:26 +02001041 $(Q)rm -f dev/hpack/decode dev/hpack/gen-enc dev/hpack/gen-rht
willy tarreauefae1842005-12-17 12:51:03 +01001042
Willy Tarreauebe0af42009-10-10 22:20:44 +02001043tags:
Willy Tarreau6db82662018-11-19 08:14:40 +01001044 $(Q)find src include \( -name '*.c' -o -name '*.h' \) -print0 | \
Willy Tarreauebe0af42009-10-10 22:20:44 +02001045 xargs -0 etags --declarations --members
1046
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001047cscope:
Willy Tarreau6db82662018-11-19 08:14:40 +01001048 $(Q)find src include -name "*.[ch]" -print | cscope -q -b -i -
William Lallemand9e5cc8d2013-10-18 16:26:39 +02001049
willy tarreaue114bf92006-03-19 21:30:14 +01001050tar: clean
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001051 $(Q)ln -s . haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
1052 $(Q)tar --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/.git \
1053 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION) \
1054 --exclude=haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz \
1055 -cf - haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/* | gzip -c9 >haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1056 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1057 $(Q)rm -f haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)
willy tarreaucee272f2006-03-19 21:16:26 +01001058
Willy Tarreau05ed29c2012-12-20 15:00:44 +01001059git-tar:
Willy Tarreauac32b4b2020-10-01 04:05:39 +02001060 $(Q)git archive --format=tar --prefix="haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION)/" HEAD | gzip -9 > haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
1061 $(Q)echo haproxy-$(VERSION)$(SUBVERS)$(EXTRAVERSION).tar.gz
Willy Tarreauec692562007-09-09 23:31:11 +02001062
1063version:
1064 @echo "VERSION: $(VERSION)"
1065 @echo "SUBVERS: $(SUBVERS)"
1066 @echo "VERDATE: $(VERDATE)"
1067
1068# never use this one if you don't know what it is used for.
1069update-version:
1070 @echo "Ready to update the following versions :"
1071 @echo "VERSION: $(VERSION)"
1072 @echo "SUBVERS: $(SUBVERS)"
1073 @echo "VERDATE: $(VERDATE)"
1074 @echo "Press [ENTER] to continue or Ctrl-C to abort now.";read
1075 echo "$(VERSION)" > VERSION
1076 echo "$(SUBVERS)" > SUBVERS
1077 echo "$(VERDATE)" > VERDATE
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001078
Willy Tarreaua8b12c62018-10-03 09:40:22 +02001079# just display the build options
1080opts:
1081 @echo -n 'Using: '
1082 @echo -n 'TARGET="$(strip $(TARGET))" '
1083 @echo -n 'ARCH="$(strip $(ARCH))" '
1084 @echo -n 'CPU="$(strip $(CPU))" '
1085 @echo -n 'CC="$(strip $(CC))" '
1086 @echo -n 'ARCH_FLAGS="$(strip $(ARCH_FLAGS))" '
1087 @echo -n 'CPU_CFLAGS="$(strip $(CPU_CFLAGS))" '
1088 @echo -n 'DEBUG_CFLAGS="$(strip $(DEBUG_CFLAGS))" '
1089 @echo "$(strip $(BUILD_OPTIONS))"
1090 @echo 'COPTS="$(strip $(COPTS))"'
1091 @echo 'LDFLAGS="$(strip $(LDFLAGS))"'
1092 @echo 'LDOPTS="$(strip $(LDOPTS))"'
1093 @echo 'OPTIONS_OBJS="$(strip $(OPTIONS_OBJS))"'
1094 @echo 'OBJS="$(strip $(OBJS))"'
1095
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001096ifeq (reg-tests, $(firstword $(MAKECMDGOALS)))
1097 REGTEST_ARGS := $(wordlist 2, $(words $(MAKECMDGOALS)), $(MAKECMDGOALS))
1098 $(eval $(REGTEST_ARGS):;@true)
1099endif
1100
Frédéric Lécaille99316342018-08-22 10:41:33 +02001101# Target to run the regression testing script files.
Frédéric Lécaille153b2b62018-06-18 19:32:10 +02001102reg-tests:
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001103 $(Q)$(REG_TEST_SCRIPT) --type "$(REGTESTS_TYPES)" $(REGTEST_ARGS) $(REG_TEST_FILES)
Frédéric Lécaillea3b4cbf2018-12-19 16:27:47 +01001104.PHONY: $(REGTEST_ARGS)
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001105
1106reg-tests-help:
1107 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001108 @echo "To launch the reg tests for haproxy, first export to your environment "
1109 @echo "VTEST_PROGRAM variable to point to your vtest program:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001110 @echo " $$ export VTEST_PROGRAM=/opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001111 @echo "or"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001112 @echo " $$ setenv VTEST_PROGRAM /opt/local/bin/vtest"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001113 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001114 @echo "The same thing may be done to set your haproxy program with HAPROXY_PROGRAM "
1115 @echo "but with ./haproxy as default value."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001116 @echo
1117 @echo "To run all the tests:"
1118 @echo " $$ make reg-tests"
1119 @echo
1120 @echo "You can also set the programs to be used on the command line:"
Frédéric Lécaille43361232019-01-11 10:10:21 +01001121 @echo " $$ VTEST_PROGRAM=<...> HAPROXY_PROGRAM=<...> make reg-tests"
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001122 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001123 @echo "To run tests with specific types:"
1124 @echo " $$ REGTESTS_TYPES=slow,default make reg-tests"
1125 @echo
William Lallemandc1ddcaf2021-02-05 11:27:54 +01001126 @echo "with 'default,bug,devel,slow' as default value for REGTESTS_TYPES variable."
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001127 @echo
1128 @echo "About the reg test types:"
1129 @echo " any : all the tests without distinction (this is the default"
1130 @echo " value of REGTESTS_TYPES."
1131 @echo " default : dedicated to pure haproxy compliance tests."
1132 @echo " slow : scripts which take non negligible time to run."
1133 @echo " bug : scripts in relation with bugs they help to reproduce."
1134 @echo " broken : scripts triggering known broken behaviors for which"
1135 @echo " there is still no fix."
1136 @echo " experimental: for scripts which are experimental, typically used to"
1137 @echo " develop new scripts."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001138 @echo
Frédéric Lécailledc1a3bd2019-03-29 15:07:24 +01001139 @echo "Note that 'reg-tests' target run '"$(REG_TEST_SCRIPT)"' script"
1140 @echo "(see --help option of this script for more information)."
Frederic Lecailled4f36e32018-12-13 22:15:05 +01001141
1142.PHONY: reg-tests reg-tests-help