granicus.if.org Git - apache/blob - 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    With Leopard (at least up to 10.5.2), when running configure
  52    you will likely see errors such as:
  53
  54       rm: conftest.dSYM: is a directory
  55
  56    This is a known issue and will be fixed in a later version of the
  57    autoconf suite. These errors can be safely ignored.
  58
  59    With Darwin 10, the default C compiler (gcc) will try to build
  60    multi-architecture bundles. This causes problems with APR, which
  61    needs to know various data-type sizes which it assumes are universal
  62    for platforms. Until this is fully fixed, we recommend using the
  63    '-arch i386' gcc option when building both Apache and APR.
  64
  65 ==========
  66   FreeBSD:
  67    autoconf 2.52 creates scripts that are incompatible with the Posix
  68    shell implementation (/bin/sh) on FreeBSD.  Be sure to use v2.13
  69    of autoconf.
  70
  71    Threaded MPMs are not supported on FreeBSD 4.x.  Current releases of
  72    FreeBSD 5.x (5.2 or later) support threaded MPMs correctly.  You must pass
  73    '--enable-threads=yes' to APR's configure in order to enable threads.
  74    Additionally, you must use libthr or libkse via libmap.conf as the default
  75    libc_r is still broken as of this writing.  Please consult the man page for
  76    libmap.conf for more details about configuring libthr or libkse.
  77 ================
  78   HP-UX:
  79    The dlopen() system call in HP-UX has problems when loading/unloading
  80    C++ modules. The problem can be resolved by using shl_load() instead
  81    of dlopen(). This is fixed in the Apache 2.0.44 release.
  82    To enable loading of C++ modules, the httpd binary has to be linked with
  83    the following libraries :
  84
  85    HP-UX (11.0 / 11i):
  86       When using shl_load        : "cpprt0_stub.s -lcl"
  87       When using dlopen          : "cpprt0_stub.s -lcl -lCsup"
  88
  89    HP-UX (11i version 1.5 and greater):
  90       When using dlopen/shl_load : "cpprt0_stub.s -lcl -lunwind"
  91
  92    The cpprt0_stub.s can be downloaded from the web site :
  93       http://h21007.www2.hp.com/hpux-devtools/CXX/hpux-devtools.0107/0083.html
  94
  95    Compile cpprt0_stub.s with the PIC option
  96      cc -c +z cpprt0_stub.s
  97        - OR -
  98      gcc -c -fPIC cpprt0_stub.s
  99 ================
 100   AIX, using the vendor C compiler with optimization:
 101     There is an issue with compiling server/core.c with optimization enabled
 102     which has been seen with C for AIX 5.0.2.3 and above.  (5.0.2.0, 5.0.2.1,
 103     and 5.0.2.2 have an additional problem with Apache 2.0.x, so either upgrade
 104     the compiler or don't use optimization in order to avoid it.)
 105
 106     cc_r works fine with -O2 but xlc_r does not.  In order to use xlc_r with
 107     -O2, apply the patch at
 108
 109     http://www.apache.org/dist/httpd/patches/apply_to_2.0.49/aix_xlc_optimization.patch
 110
 111     (That patch works with many recent levels of Apache 2+.)
 112
 113 ================
 114   Solaris:
 115
 116     On Solaris, better performance may be achieved by using the Sun Studio
 117     compiler instead of gcc.  As of version 11, it is now free (registration
 118     required).  Download the compiler from:
 119
 120     http://developers.sun.com/prodtech/cc/downloads/index.jsp
 121
 122     If you use Sun Studio, the following compiler flags (CFLAGS) are
 123     recommended:
 124
 125       -XO4 -xchip=generic
 126