bottleneck testcase based on rubbos
[bottlenecks.git] / rubbos / app / httpd-2.0.64 / README.platforms
1
2                           Apache HTTP Server
3
4   Platform specific notes:
5   ------------------------
6
7 ================
8   Darwin (OS X):
9    Apache 2.0 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.0 knows about this so that's not
14    a problem.
15
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.5.2 and (g)libtool 1.4.2.
20
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
29    page to check out is:
30
31       http://fink.sourceforge.net/doc/porting/libtool.php
32
33    Pier Fumagalli also provides pre-built Darwin packages of the
34    patched autoconf and libtool suites, available at:
35
36       http://www.apache.org/~pier/macosx/
37
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.
43
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
49    on Darwin) will help.
50
51 ==========
52   FreeBSD:
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
55    of autoconf.
56
57 ================
58   HP-UX:
59    The dlopen() system call in HP-UX has problems when loading/unloading
60    C++ modules. The problem can be resolved by using shl_load() instead
61    of dlopen(). This is fixed in the Apache 2.0.44 release.
62    To enable loading of C++ modules, the httpd binary has to be linked with
63    the following libraries :
64
65    HP-UX (11.0 / 11i):
66       When using shl_load        : "cpprt0_stub.s -lcl"
67       When using dlopen          : "cpprt0_stub.s -lcl -lCsup"
68
69    HP-UX (11i version 1.5 and greater):
70       When using dlopen/shl_load : "cpprt0_stub.s -lcl -lunwind"
71
72    The cpprt0_stub.s can be downloaded from the web site :
73       http://h21007.www2.hp.com/hpux-devtools/CXX/hpux-devtools.0107/0083.html
74
75    Compile cpprt0_stub.s with the PIC option
76      cc -c +z cpprt0_stub.s
77        - OR -
78      gcc -c -fPIC cpprt0_stub.s
79
80 ================
81   AIX, using the vendor C compiler with optimization:
82     There is an issue with compiling server/core.c with optimization enabled
83     which has been seen with C for AIX 5.0.2.3 and above.  (5.0.2.0, 5.0.2.1,
84     and 5.0.2.2 have an additional problem with Apache 2.0.x, so either upgrade 
85     the compiler or don't use optimization in order to avoid it.)
86
87     cc_r works fine with -O2 but xlc_r does not.  In order to use xlc_r with
88     -O2, apply the patch at 
89
90     http://www.apache.org/dist/httpd/patches/apply_to_2.0.49/aix_xlc_optimization.patch
91
92     (That patch works with many recent levels of Apache 2+.)