Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 75 lines (56 sloc) 3.209 kb
7834533 * added a README to help about the build process
willy tarreau authored
1 -------------------
2 H A - P r o x y
3 How to build it
4 -------------------
5 version 1.2.7
6 willy tarreau
7 2005/10/25
8
9
10 To build haproxy, you will need :
11 - GNU make. Neither Solaris nor OpenBSD's make work with this makefile.
12 - GCC between 2.91 and 3.4. Others may work, but not tested.
13 - GNU ld
14
15 Also, you might want to build with libpcre support, which will provide a very
16 efficient regex implementation and will also fix some badness on Solaris's one.
17
18 To build haproxy, you have to choose your target OS amongst the following ones
19 and assign it to the TARGET variable :
20
21 - linux24 for Linux 2.4 and above (default)
22 - linux24e for Linux 2.4 with support for epoll
23 - linux26 for Linux 2.6 and above
24 - linux22 for Linux 2.2
25 - solaris for Solaris 8 or 10 (others untested)
26 - openbsd for OpenBSD 3.1 to 3.7 (others untested)
27 - generic for any other OS.
28
29 You may also choose your CPU to benefit from some optimizations. This is
30 particularly important on UltraSparc machines. For this, you can assign
31 one of the following choices to the CPU variable :
32
33 - i686 for intel PentiumPro, Pentium 2 and above, AMD Athlon
34 - i586 for intel Pentium, AMD K6, VIA C3.
35 - ultrasparc : Sun UltraSparc I/II/III/IV processor
36 - generic : any other processor or no specific optimization. (default)
37
38 If your system supports PCRE (Perl Compatible Regular Expressions), then you
39 really should build with libpcre which is between 2 and 10 times faster than
40 other libc implementations. Regex are used for header processing (deletion,
41 rewriting, allow, deny). The only inconvenient of libpcre is that it is not
42 yet widely spread, so if you build for other systems, you might get into
43 trouble if they don't have the dynamic library. In this situation, you should
44 statically link libpcre into haproxy so that it will not be necessary to
45 install it on target systems. Available options for the REGEX variable are :
46
47 - libc to use your OS libc's standard regex implemntation (default).
48 Warning! group references on Solaris seem broken. Use static-pcre whenever
49 possible.
50
51 - pcre to use libpcre, in whatever form it is available on your system
52 (shared or static)
53
54 - static-pcre to use a static version of libpcre even if the dynamic one is
55 available. This will enhance portability.
56
57 By default, the DEBUG variable is set to '-g' to enable debug symbols. It is
58 not wise to disable it on uncommon systems, because it's often the only way to
59 get a complete core when you need one. Otherwise, you can set DEBUG to '-s' to
60 strip the binary.
61
62 For example, I use this to build for Solaris 8 :
63
64 $ make TARGET=solaris CPU=ultrasparc REGEX=static-pcre
65
d38e72d Separated OpenBSD build from the main Makefile into a new one.
willy tarreau authored
66 And I build it this way on OpenBSD :
67
68 $ make -f Makefile.bsd REGEX=pcre DEBUG= COPTS.generic="-Os -fomit-frame-pointer -mgnu"
69
7834533 * added a README to help about the build process
willy tarreau authored
70 If you need to pass other defines, includes, libraries, etc... then please
71 check the Makefile to see which ones will be available in your case, and
72 use the ADDINC, ADDLIB, and DEFINE variables for this.
73
74 -- end
Something went wrong with that request. Please try again.