Home | History | Annotate | only in /webstack/webstack/trunk/src/httpd-2.2.6
Up to higher level directory
NameDateSize
.deps08-Dec-20080
.gdbinit08-Dec-20087K
ABOUT_APACHE08-Dec-200814.5K
acinclude.m408-Dec-200818.4K
Apache.dsw08-Dec-200849.9K
apachenw.mcp.zip08-Dec-2008184.7K
build/08-Dec-2008
BuildAll.dsp08-Dec-20082.6K
BuildBin.dsp08-Dec-20082.6K
buildconf08-Dec-20085.6K
CHANGES08-Dec-200865.4K
config.layout08-Dec-200810.7K
configure08-Dec-2008653.1K
configure.in08-Dec-200822.4K
docs/08-Dec-2008
emacs-style08-Dec-2008403
httpd.dsp08-Dec-20084K
httpd.spec08-Dec-200818.7K
include/08-Dec-2008
INSTALL08-Dec-20083.7K
InstallBin.dsp08-Dec-20082.8K
LAYOUT08-Dec-20085K
libhttpd.dsp08-Dec-200816.6K
LICENSE08-Dec-200830.9K
make_solaris.sh08-Dec-20081.7K
Makefile.in08-Dec-20088.4K
Makefile.win08-Dec-200832.7K
modules/08-Dec-2008
NOTICE08-Dec-2008828
NWGNUmakefile08-Dec-200810.3K
os/08-Dec-2008
README08-Dec-20085.8K
README.platforms08-Dec-20084.6K
ROADMAP08-Dec-20089.9K
server/08-Dec-2008
srclib/08-Dec-2008
support/08-Dec-2008
test/08-Dec-2008
VERSIONING08-Dec-20088K

README

      1 
      2                           Apache HTTP Server
      3 
      4   What is it?
      5   -----------
      6 
      7   The Apache HTTP Server is a powerful and flexible HTTP/1.1 compliant
      8   web server.  Originally designed as a replacement for the NCSA HTTP
      9   Server, it has grown to be the most popular web server on the
     10   Internet.  As a project of the Apache Software Foundation, the
     11   developers aim to collaboratively develop and maintain a robust,
     12   commercial-grade, standards-based server with freely available
     13   source code.
     14 
     15   The Latest Version
     16   ------------------
     17 
     18   Details of the latest version can be found on the Apache HTTP
     19   server project page under <http://httpd.apache.org/>.
     20 
     21   Documentation
     22   -------------
     23 
     24   The documentation available as of the date of this release is
     25   included in HTML format in the docs/manual/ directory.  The most
     26   up-to-date documentation for the 2.2.x releases can be found at
     27   <http://httpd.apache.org/docs/2.2/>.
     28 
     29   Installation
     30   ------------
     31 
     32   Please see the file called INSTALL.  Platform specific notes can be
     33   found in README.platforms.
     34 
     35   Licensing
     36   ---------
     37 
     38   Please see the file called LICENSE.
     39 
     40   Cryptographic Software Notice
     41   -----------------------------
     42 
     43   This distribution may include software that has been designed for use
     44   with cryptographic software.  The country in which you currently reside
     45   may have restrictions on the import, possession, use, and/or re-export
     46   to another country, of encryption software.  BEFORE using any encryption
     47   software, please check your country's laws, regulations and policies
     48   concerning the import, possession, or use, and re-export of encryption
     49   software, to see if this is permitted.  See <http://www.wassenaar.org/>
     50   for more information.
     51 
     52   The U.S. Government Department of Commerce, Bureau of Industry and
     53   Security (BIS), has classified this software as Export Commodity 
     54   Control Number (ECCN) 5D002.C.1, which includes information security
     55   software using or performing cryptographic functions with asymmetric
     56   algorithms.  The form and manner of this Apache Software Foundation
     57   distribution makes it eligible for export under the License Exception
     58   ENC Technology Software Unrestricted (TSU) exception (see the BIS 
     59   Export Administration Regulations, Section 740.13) for both object 
     60   code and source code.
     61 
     62   The following provides more details on the included files that
     63   may be subject to export controls on cryptographic software:
     64 
     65     Apache httpd 2.0 and later versions include the mod_ssl module under
     66        modules/ssl/
     67     for configuring and listening to connections over SSL encrypted
     68     network sockets by performing calls to a general-purpose encryption
     69     library, such as OpenSSL or the operating system's platform-specific
     70     SSL facilities.
     71 
     72     In addition, some versions of apr-util provide an abstract interface
     73     for SSL encrypted network sockets in the files under the directory
     74        srclib/apr-util/ssl/
     75     that makes use of a general-purpose encryption library, such as
     76     OpenSSL or the operating system's platform-specific SSL facilities.
     77     Apache httpd currently does not use that apr-util interface.
     78 
     79     Some object code distributions of Apache httpd, indicated with the
     80     word "crypto" in the package name, may include object code for the
     81     OpenSSL encryption library as distributed in open source form from
     82     <http://www.openssl.org/source/>.
     83 
     84   The above files are optional and may be removed if the cryptographic
     85   functionality is not desired or needs to be excluded from redistribution.
     86   Distribution packages of Apache httpd that include the word "nossl"
     87   in the package name have been created without the above files and are
     88   therefore not subject to this notice.
     89 
     90   Contacts
     91   --------
     92 
     93      o If you want to be informed about new code releases, bug fixes,
     94        security fixes, general news and information about the Apache server
     95        subscribe to the apache-announce mailing list as described under
     96        <http://httpd.apache.org/lists.html#http-announce>
     97 
     98      o If you want freely available support for running Apache please join the
     99        Apache user community by subscribing to Users Mailing List at
    100        <http://httpd.apache.org/userslist.html> or one of the following
    101        USENET newsgroups:
    102          comp.infosystems.www.servers.unix
    103          comp.infosystems.www.servers.ms-windows
    104        Also available at: 
    105          <http://groups.google.com/groups?group=comp.infosystems.www.servers>
    106 
    107      o If you want commercial support for running Apache please contact
    108        one of the companies and contractors which are listed at
    109        <http://www.apache.org/info/support.cgi>
    110 
    111      o If you have a concrete bug report for Apache please go to the
    112        Apache Group Bug Database and submit your report:
    113        <http://httpd.apache.org/bug_report.html>
    114 
    115      o If you want to participate in actively developing Apache please
    116        subscribe to the `dev (a] httpd.apache.org' mailing list as described at
    117        <http://httpd.apache.org/lists.html#http-dev>
    118 
    119   Acknowledgments
    120   ----------------
    121 
    122   We wish to acknowledge the following copyrighted works that
    123   make up portions of the Apache software:
    124 
    125   Portions of this software were developed at the National Center
    126   for Supercomputing Applications (NCSA) at the University of
    127   Illinois at Urbana-Champaign.
    128 
    129   This software contains code derived from the RSA Data Security
    130   Inc. MD5 Message-Digest Algorithm, including various
    131   modifications by Spyglass Inc., Carnegie Mellon University, and
    132   Bell Communications Research, Inc (Bellcore).
    133 
    134   Regular expression support is provided by the PCRE library package, which
    135   is open source software, written by Philip Hazel, and copyright by the
    136   University of Cambridge, England.  The original software is available from
    137      ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/
    138 
    139   Apache 2 relies heavily on the use of autoconf and libtool to provide
    140   a build environment.
    141 

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 
     99 ================
    100   Solaris:
    101 
    102     On Solaris, better performance may be achieved by using the Sun Studio
    103     compiler instead of gcc.  As of version 11, it is now free (registration
    104     required).  Download the compiler from:
    105 
    106     http://developers.sun.com/prodtech/cc/downloads/index.jsp
    107 
    108     If you use Sun Studio, the following compiler flags (CFLAGS) are
    109     recommended:
    110 
    111       -XO4 -xchip=generic
    112 
    113