]> git.ipfire.org Git - thirdparty/haproxy.git/commitdiff
DOC: install: update quick build reminders with some missing options
authorWilly Tarreau <w@1wt.eu>
Wed, 29 May 2024 06:43:01 +0000 (08:43 +0200)
committerWilly Tarreau <w@1wt.eu>
Wed, 29 May 2024 06:43:01 +0000 (08:43 +0200)
The quick build reminders claimed to present "all options" but were
still missing QUIC. It was also the moment to split FreeBSD and
OpenBSD apart since the latter uses LibreSSL and does not require
the openssl compatibility wrapper. We also replace the hard-coded
number of cpus for the parallel build, by the real number reported
by the system.

INSTALL

diff --git a/INSTALL b/INSTALL
index d0cd4d1ba0ec9b9205c3fe87140c4e41097ca0bc..0067f38e64272c5902ef0db41b262777c29f131b 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -34,18 +34,26 @@ are a few build examples :
   - recent Linux system with all options, make and install :
     $ make clean
     $ make -j $(nproc) TARGET=linux-glibc \
-                USE_OPENSSL=1 USE_LUA=1 USE_PCRE2=1 USE_SYSTEMD=1
+           USE_OPENSSL=1 USE_QUIC=1 USE_QUIC_OPENSSL_COMPAT=1 \
+           USE_LUA=1 USE_PCRE2=1
     $ sudo make install
 
-  - FreeBSD and OpenBSD, build with all options :
-    $ gmake -j 4 TARGET=freebsd USE_OPENSSL=1 USE_LUA=1 USE_PCRE2=1
+  - FreeBSD + OpenSSL, build with all options :
+    $ gmake -j $(sysctl -n hw.ncpu) TARGET=freebsd \
+           USE_OPENSSL=1 USE_QUIC=1 USE_QUIC_OPENSSL_COMPAT=1 \
+           USE_LUA=1 USE_PCRE2=1
+
+  - OpenBSD + LibreSSL, build with all options :
+    $ gmake -j $(sysctl -n hw.ncpu) TARGET=openbsd \
+           USE_OPENSSL=1 USE_QUIC=1 USE_LUA=1 USE_PCRE2=1
 
   - embedded Linux, build using a cross-compiler :
     $ make -j $(nproc) TARGET=linux-glibc USE_OPENSSL=1 USE_PCRE2=1 \
-                CC=/opt/cross/gcc730-arm/bin/gcc ADDLIB=-latomic
+           CC=/opt/cross/gcc730-arm/bin/gcc CFLAGS="-mthumb" ADDLIB=-latomic
 
   - Build with static PCRE on Solaris / UltraSPARC :
-    $ make TARGET=solaris CPU_CFLAGS="-mcpu=v9" USE_STATIC_PCRE2=1
+    $ make -j $(/usr/sbin/psrinfo -p) TARGET=solaris \
+           CPU_CFLAGS="-mcpu=v9" USE_STATIC_PCRE2=1
 
 For more advanced build options or if a command above reports an error, please
 read the following sections.