4 Platform specific notes:
5 ------------------------
9 Apache 2 relies heavily on the use of autoconf and libtool to
10 provide a build environment. Darwin provides these tools as part
11 of the Developers Tools package. Under Darwin, however, GNUlibtool
12 is installed as 'glibtool' to avoid conflicting with the Darwin
13 'libtool' program. Apache 2 knows about this so that's not a
16 As of OS X 10.2 (Jaguar), the bundled versions work perfectly. Partly
17 this is due to the fact that /bin/sh is now 'bash' and not 'zsh' as
18 well as the fact that the bundled versions are up-to-date:
19 autoconf 2.52 and (g)libtool 1.4.2.
21 Earlier versions of OS X are not so fortunate, and the bundled tools
22 are not only older versions, but also, for the most part, do not work
23 well. If you are interested in developing under Darwin, we
24 recommend that you obtain and install replacement versions of what
25 are normally installed on Darwin (and OS X, as of v10.1.5). If
26 you build your own versions of autoconf 2.52 and libtool 1.4.2, be
27 aware that there are some Darwin specific patches to the official
28 code that still must be applied for them to fully work. A useful
31 http://fink.sourceforge.net/doc/porting/libtool.php
33 Pier Fumagalli also provides pre-built Darwin packages of the
34 patched autoconf and libtool suites, available at:
36 http://www.apache.org/~pier/macosx/
38 You will note that GNU libtool should actually be installed as
39 glibtool, to avoid conflict with a Darwin program of the same
40 name. Pier's packages have this change already. All files are
41 installed under /usr/local/ so to use these versions, and be sure
42 that /usr/local/bin is earlier in your PATH.
44 There have been some reports that autoconf 2.52 prevents Apache's
45 build system from correctly handling passing multi-value envvars
46 to the build system (eg: CFLAGS="-g -O3" ./configure), causing
47 errors. Use of bash does not seem to help in this situation. If
48 this affects you, downgrading to autoconf 2.13 (which is installed
53 autoconf 2.52 creates scripts that are incompatible with the Posix
54 shell implementation (/bin/sh) on FreeBSD. Be sure to use v2.13
57 Threaded MPMs are not supported on FreeBSD 4.x. Current releases of
58 FreeBSD 5.x (5.2 or later) support threaded MPMs correctly. You must pass
59 '--enable-threads=yes' to APR's configure in order to enable threads.
60 Additionally, you must use libthr or libkse via libmap.conf as the default
61 libc_r is still broken as of this writing. Please consult the man page for
62 libmap.conf for more details about configuring libthr or libkse.
65 The dlopen() system call in HP-UX has problems when loading/unloading
66 C++ modules. The problem can be resolved by using shl_load() instead
67 of dlopen(). This is fixed in the Apache 2.0.44 release.
68 To enable loading of C++ modules, the httpd binary has to be linked with
69 the following libraries :
72 When using shl_load : "cpprt0_stub.s -lcl"
73 When using dlopen : "cpprt0_stub.s -lcl -lCsup"
75 HP-UX (11i version 1.5 and greater):
76 When using dlopen/shl_load : "cpprt0_stub.s -lcl -lunwind"
78 The cpprt0_stub.s can be downloaded from the web site :
79 http://h21007.www2.hp.com/hpux-devtools/CXX/hpux-devtools.0107/0083.html
81 Compile cpprt0_stub.s with the PIC option
82 cc -c +z cpprt0_stub.s
84 gcc -c -fPIC cpprt0_stub.s