← Back to branch summary

~ubuntu-branches/ubuntu/feisty/apache2/feisty

« back to all changes in this revision

Viewing changes to README.platforms

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Barth
  • Date: 2006-12-09 21:05:45 UTC
  • mfrom: (0.6.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209210545-h70s0xaqc2v8vqr2
Tags: 2.2.3-3.2
http://bugs.debian.org/396265
* Non-maintainer upload.
* 043_ajp_connection_reuse: Patch from upstream Bugzilla, fixing a critical
  issue with regard to connection reuse in mod_proxy_ajp.
  Closes: #396265

Show diffs side-by-side

added added

removed removed

Lines of Context:
README.platforms
 
1
 
 
2
                          Apache HTTP Server
 
3
 
 
4
  Platform specific notes:
 
5
  ------------------------
 
6
 
 
7
================
 
8
  Darwin (OS X):
 
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
 
14
   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.52 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
   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.
 
63
================
 
64
  HP-UX:
 
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 :
 
70
 
 
71
   HP-UX (11.0 / 11i):
 
72
      When using shl_load        : "cpprt0_stub.s -lcl"
 
73
      When using dlopen          : "cpprt0_stub.s -lcl -lCsup"
 
74
 
 
75
   HP-UX (11i version 1.5 and greater):
 
76
      When using dlopen/shl_load : "cpprt0_stub.s -lcl -lunwind"
 
77
 
 
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
 
80
 
 
81
   Compile cpprt0_stub.s with the PIC option
 
82
     cc -c +z cpprt0_stub.s
 
83
       - OR -
 
84
     gcc -c -fPIC cpprt0_stub.s
 
85
================
 
86
  AIX, using the vendor C compiler with optimization:
 
87
    There is an issue with compiling server/core.c with optimization enabled
 
88
    which has been seen with C for AIX 5.0.2.3 and above.  (5.0.2.0, 5.0.2.1,
 
89
    and 5.0.2.2 have an additional problem with Apache 2.0.x, so either upgrade 
 
90
    the compiler or don't use optimization in order to avoid it.)
 
91
 
 
92
    cc_r works fine with -O2 but xlc_r does not.  In order to use xlc_r with
 
93
    -O2, apply the patch at 
 
94
 
 
95
    http://www.apache.org/dist/httpd/patches/apply_to_2.0.49/aix_xlc_optimization.patch
 
96
 
 
97
    (That patch works with many recent levels of Apache 2+.)
 
98