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 ==========
  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