configure.xml revision 28ec5e4f5c4a71428affc986304e894eda600925
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher<!DOCTYPE manualpage SYSTEM "/style/manualpage.dtd">
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher<!-- $LastChangedRevision$ -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher Licensed to the Apache Software Foundation (ASF) under one or more
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher contributor license agreements. See the NOTICE file distributed with
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher this work for additional information regarding copyright ownership.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher The ASF licenses this file to You under the Apache License, Version 2.0
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher (the "License"); you may not use this file except in compliance with
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher the License. You may obtain a copy of the License at
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher http://www.apache.org/licenses/LICENSE-2.0
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher Unless required by applicable law or agreed to in writing, software
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher distributed under the License is distributed on an "AS IS" BASIS,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher See the License for the specific language governing permissions and
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher limitations under the License.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher<parentdocument href="./">Programs</parentdocument>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <title>configure - Configure the source tree</title>
e0404de84c31d2387bb244d018a5cac8d01f8b19Simo Sorce <p>The <code>configure</code> script configures the source tree
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher for compiling and installing the Apache HTTP Server on your
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher particular platform. Various options allow the compilation of a
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher server corresponding to your personal requirements.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>This script, included in the root directory of the source
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher distribution, is for compilation on Unix and Unix-like systems
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher only. For other platforms, see the <a
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher href="/platform/">platform</a> documentation.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher<seealso><a href="/install.html">Compiling and Installing</a></seealso>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov<section id="synopsis"><title>Synopsis</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>You should call the <code>configure</code> script from within the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher root directory of the distribution.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p><code><strong>/configure</strong> [<var>OPTION</var>]...
e2ac9be4f293b96f3c8992f1171e44bc1da5cfcaMichal Zidek [<var>VAR</var>=<var>VALUE</var>]...</code></p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>To assign environment variables (e.g. <code>CC</code>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>VAR</var>=<var>VALUE</var></code>. See <a href="#env">below</a>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher for descriptions of some of the useful variables.</p>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov<section id="options"><title>Options</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <li><a href="#configurationoptions">Configuration options</a></li>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <li><a href="#installationdirectories">Installation directories</a></li>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <li><a href="#systemtypes">System types</a></li>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <li><a href="#optionalfeatures">Optional features</a></li>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <li><a href="#supportopt">Options for support programs</a></li>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="configurationoptions"><title>Configuration options</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>The following options influence the behavior of
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>This is an alias for <code>--cache-file=config.cache</code></dd>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dt><code>--cache-file=<var>FILE</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>The test results will be cached in file <var>FILE</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher This option is disabled by default.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--help [short|recursive]</code></dt>
d115f40c7a3999e3cbe705a2ff9cf0fd493f80fbMichal Zidek <dd>Output the help and exit. With the argument <code>short</code> only
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher options specific to this package will displayed. The argument
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <code>recursive</code> displays the short help of all the included
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher packages.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>The <code>configure</code> script is run normally but does
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher not create output files. This is useful to check the test results
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher before generating makefiles for compilation.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Do not print <code>checking ...</code> messages during the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher configure process.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--srcdir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Defines directory <var>DIR</var> to be the source file directory.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher Default is the directory where <code>configure</code> is located, or
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher the parent directory.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Display copyright information and exit.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="installationdirectories"><title>Installation
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher directories</title>
e0404de84c31d2387bb244d018a5cac8d01f8b19Simo Sorce <p>These options define the installation directory. The installation
21d485184df986e1a123f70c689517386e51a5ceMichal Zidek tree depends on the selected layout.</p>
21d485184df986e1a123f70c689517386e51a5ceMichal Zidek <dt><code>--prefix=<var>PREFIX</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install architecture-independent files in <var>PREFIX</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher By default the installation directory is set to
e0404de84c31d2387bb244d018a5cac8d01f8b19Simo Sorce <dt><code>--exec-prefix=<var>EPREFIX</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install architecture-dependent files in <var>EPREFIX</var>.
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov By default the installation directory is set to the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>By default, <code>make install</code> will install all the files in
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>/usr/local/apache2/bin</code>, <code>/usr/local/apache2/lib</code>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher etc. You can specify an installation prefix other than
e0404de84c31d2387bb244d018a5cac8d01f8b19Simo Sorce <code>/usr/local/apache2</code> using <code>--prefix</code>,
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <section id="layout"><title>Define a directory layout</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-layout=<var>LAYOUT</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Configure the source code and build scripts to assume an
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher installation tree based on the layout <var>LAYOUT</var>. This allows
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher you to separately specify the locations for each type of file within
e0404de84c31d2387bb244d018a5cac8d01f8b19Simo Sorce the Apache HTTP Server installation. The <code>config.layout</code>
21d485184df986e1a123f70c689517386e51a5ceMichal Zidek file contains several example configurations, and you can also create
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov your own custom configuration following the examples. The different
21d485184df986e1a123f70c689517386e51a5ceMichal Zidek layouts in this file are grouped into <code><Layout
21d485184df986e1a123f70c689517386e51a5ceMichal Zidek FOO>...</Layout></code> sections and referred to by name as
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher in <code>FOO</code>. The default layout is <code>Apache</code>.</dd>
e0404de84c31d2387bb244d018a5cac8d01f8b19Simo Sorce <section id="directoryfinetuning"><title>Fine tuning of the installation
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher directories</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>For better control of the installation directories, use the options
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher below. Please note that the directory defaults are set by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>autoconf</code> and are overwritten by the corresponding layout
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- only apr-config and apu-config are installed at bindir.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher everything else is stored at sbindir. ==> clarify/change this -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--bindir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install user executables in <var>DIR</var>. The user executables
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher are supporting programs like <program>htpasswd</program>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <program>dbmmanage</program>, etc. which are useful for site
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher administrators. By default <var>DIR</var> is set to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--datadir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install read-only architecture-independent data in <var>DIR</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>PREFIX</var>/share</code>. This option is offered by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>autoconf</code> and currently unused.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--includedir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install C header files in <var>DIR</var>. By default
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>EPREFIX</var>/include</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--infodir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install info documentation in <var>DIR</var>.
3d8a87081a6cd197acbd355b5a39111669ec2aa6Jakub Hrozek <code><var>PREFIX</var>/info</code>. This option is currently
3d8a87081a6cd197acbd355b5a39111669ec2aa6Jakub Hrozek unused.</dd>
3d8a87081a6cd197acbd355b5a39111669ec2aa6Jakub Hrozek <dd>Install object code libraries in <var>DIR</var>. By default
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--libexecdir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install the program executables (i.e., shared modules) in
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <var>DIR</var>. By default <code>libexecdir</code> is set to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>EPREFIX</var>/libexec</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--localstatedir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install modifiable single-machine data in <var>DIR</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher By default <code>localstatedir</code> is set to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>PREFIX</var>/var</code>. This option is offered by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>autoconf</code> and currently unused.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--mandir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install the man documentation in <var>DIR</var>. By default
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--oldincludedir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install C header files for non-gcc in <var>DIR</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher By default <code>oldincludedir</code> is set to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>/usr/include</code>. This option is offered by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>autoconf</code> and currently unused.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--sbindir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install the system administrator executables in <var>DIR</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher Those are server programs like <program>httpd</program>,
9f37bb2012faa136ef7c1f9fe93689ce2be85637Ondrej Kos <program>apachectl</program>, <program>suexec</program>, etc. which
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher are neccessary to run the Apache HTTP Server. By default
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>EPREFIX</var>/sbin</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--sharedstatedir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install modifiable architecture-independent data in <var>DIR</var>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher By default <code>sharedstatedir</code> is set to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code><var>PREFIX</var>/com</code>. This option is offered by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>autoconf</code> and currently unused.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--sysconfdir=<var>DIR</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Install read-only single-machine data like the server configuration
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher files <code>httpd.conf</code>, <code>mime.types</code>, etc. in
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <var>DIR</var>. By default <code>sysconfdir</code> is set to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="systemtypes"><title>System types</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>These options are used to cross-compile the Apache HTTP Server to run on
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov another system. In normal cases, when building and running the server on
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher the same system, these options are not used.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--build=<var>BUILD</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Defines the system type of the system on which the tools are being
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher built. It defaults to the result of the script
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dt><code>--host=<var>HOST</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Defines the system type of the system on which the server will run.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <var>HOST</var> defaults to <var>BUILD</var>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--target=<var>TARGET</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Configure for building compilers for the system type
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <var>TARGET</var>. It defaults to <var>HOST</var>. This option is
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher offered by <code>autoconf</code> and not necessary for the Apache HTTP
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="optionalfeatures"><title>Optional Features</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>These options are used to fine tune the features your HTTP server will
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="generaloptfeat"><title>General syntax</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>Generally you can use the following syntax to enable or disable a
03abdaa21ecf562b714f204ca42379ff08626f75Simo Sorce feature:</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--disable-<var>FEATURE</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Do not include <var>FEATURE</var>. This is the same as
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>--enable-<var>FEATURE</var>=no</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-<var>FEATURE</var>[=<var>ARG</var>]</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Include <var>FEATURE</var>. The default value for <var>ARG</var>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-<var>MODULE</var>=shared</code></dt>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dd>The corresponding module will be build as DSO module.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-<var>MODULE</var>=static</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>By default enabled modules are linked statically. You can force
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher this explicitly.</dd>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <code>configure</code> will not complain about
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>--enable-<var>foo</var></code> even if <var>foo</var> doesn't
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher exist, so you need to type carefully.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- to do: add better enable-module descriptions and recommendations -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="enabledmodules"><title>Modules enabled by default</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>Some modules are compiled by default and have to be disabled
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher explicitly. Use the following options to remove discrete modules from
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher the compilation process.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable action triggering on requests, which is provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable the mapping of requests to different parts of the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher filesystem, which is provided by <module>mod_alias</module>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable support for as-is filetypes, which is provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable user-based access control provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_auth</module>. This module provides for HTTP Basic
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov Authentication, where the usernames and passwords are stored in
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov plain text files.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable the directory listing functionality provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable host-based access control provided by
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dd><module>mod_cgi</module>, which provides support for CGI scripts,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher is enabled by default when using a non-threaded MPM. Use this
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher option to disable CGI support.</dd>
03abdaa21ecf562b714f204ca42379ff08626f75Simo Sorce <dd>When using the threaded MPMs <module>worker</module> or
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>perchild</module> support for CGI scripts is provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_cgid</module> by default. To disable CGI support use
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher this option.</dd>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dt><code>--disable-charset-lite</code></dt>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dd>Disable character set translation provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_charset_lite</module>. This module will be installed by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher default only on EBCDIC systems.</dd>
6fb75e297bf7fc83e3db1f5ae8560624656ef319Jan Zeleny <dd>Disable directory request handling provided by
6fb75e297bf7fc83e3db1f5ae8560624656ef319Jan Zeleny <dd>Disable setting and clearing of environment variables, which is
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- configure mentions enable-http, but disable-http would make much
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov more sense -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable the HTTP protocol handling. The <code>http</code>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher module is a basic one, enabling the server to function as an
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher HTTP server. It is only useful to disable it if you want to use
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher another protocol module instead. <strong>Don't disable this
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher module unless you are really sure what you are doing.</strong>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher Note: This module will always be linked statically.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable support for server based imagemaps, which provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable Server Side Includes provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--disable-log-config</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable the logging configuration provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_log_config</module>. You won't be able to log requests
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher to the server without this module.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd><module>mod_mime</module> associates the requested
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher filename's extensions with the file's behavior and content
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher (<glossary>mime-type</glossary>, language, character set and
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher encoding). Disabling this module is normally not recommended.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--disable-negotiation</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable content negotiation provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable support for basing environment variables on headers,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher which is provided by <module>mod_setenvif</module>.</dd>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dd>Disable the process/thread monitoring, which is provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Disable the mapping of requests to user-specific directories,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher which is provided by <module>mod_userdir</module>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="disabledmodules"><title>Modules, disabled by default</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>Some modules are compiled by default and have to be enabled
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher explicitly or by using the keywords <code>most</code> or
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>all</code> (see <code>--enable-mods-shared</code> below for
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher further explanation) to be available. Therefore use the options
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable anonymous user access provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd><module>mod_auth_dbm</module> provides for HTTP Basic
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher Authentication, where the usernames and passwords are stored in DBM
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher type database files. Use this option to enable the module.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-auth-digest</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable RFC2617 Digest authentication provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_auth_digest</module>. This module uses plain text files
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher to store the credentials.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-authnz-ldap</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable LDAP based authentication provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable dynamic file caching provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_cache</module>. This experimental module may be
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher interesting for servers with high load or caching proxy servers. At
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher least one storage management module (e.g.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_disk_cache</module> or <module>mod_mem_cache</module>)
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher is also necessary.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the CERN-type meta files support provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-charset-lite</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable character set translation provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_charset_lite</module>. This module will be installed by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher default only on EBCDIC systems. On other systems, you have to enable
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the WebDAV protocol handling provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_dav</module>. Support for filesystem resources is
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher provided by the separate module <module>mod_dav_fs</module>. This
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher module is also automatically enabled with
94a66f84bd3c28fcabffeb84c682dccf89d89c2bSumit Bose Note: <module>mod_dav</module> can only be used together with the
94a66f84bd3c28fcabffeb84c682dccf89d89c2bSumit Bose <dd>Enable DAV support for filesystem resources, which is provided by
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <module>mod_dav_fs</module>. This module is a provider for the
94a66f84bd3c28fcabffeb84c682dccf89d89c2bSumit Bose <module>mod_dav</module> module, so you should also use
94a66f84bd3c28fcabffeb84c682dccf89d89c2bSumit Bose <dd>Enable <module>mod_dav_lock</module> which provides generic DAV
94a66f84bd3c28fcabffeb84c682dccf89d89c2bSumit Bose locking support for backend modules. This module needs at least
b860f8b6b6b03982c80268e9f6fd35f6455b6b37Simo Sorce <module>mod_dav</module> to function, so you should also use
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable deflate transfer encoding provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable disk caching provided by
9b72b00ebcfd6225a4e139619c8e18d44a448f87Stephen Gallagher <dd>Enable Expires header control provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the external filter support provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the file cache provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable control of HTTP headers provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the server information provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable LDAP caching and connection pooling services provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable logging of input and output bytes including headers provided
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable memory caching provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher automatical determining of <glossary ref="mime-type">MIME
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher types</glossary>, which is provided by
2ce00e0d3896bb42db169d1e79553a81ca837a22Simo Sorce <dd>Enable the isapi extension support provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the proxy/gateway functionality provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_proxy</module>. The proxying capabilities for
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>AJP13</code>, <code>CONNECT</code>, <code>FTP</code>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>HTTP</code> and the balancer are provided by the separate
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_proxy_connect</module>, <module>mod_proxy_ftp</module>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher These five modules are also automatically enabled with
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable proxy support for <code>AJP13 (Apache JServ Protocol 1.3)</code>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher request handling, which is provided by <module>mod_proxy_ajp</module>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher This module is an extension for the <module>mod_proxy</module> module,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher so you should also use <code>--enable-proxy</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-proxy-balancer</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable load balancing support for the <code>AJP13</code>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>FTP</code> and <code>HTTP</code> protocols, which is provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_proxy_balancer</module>. This module is an extension for the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mod_proxy</module> module, so you should also use
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-proxy-connect</code></dt>
4c08db0fb0dda3d27b1184248ca5c800d7ce23f0Michal Zidek <dd>Enable proxy support for <code>CONNECT</code> request handling,
4c08db0fb0dda3d27b1184248ca5c800d7ce23f0Michal Zidek which is provided by <module>mod_proxy_connect</module>. This module
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher is an extension for the <module>mod_proxy</module> module, so you
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov should also use <code>--enable-proxy</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable proxy support for <code>FTP</code> requests, which is
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher provided by <module>mod_proxy_ftp</module>. This module
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher is an extension for the <module>mod_proxy</module> module, so you
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher should also use <code>--enable-proxy</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable proxy support for <code>HTTP</code> requests, which is
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher provided by <module>mod_proxy_http</module>. This module
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov is an extension for the <module>mod_proxy</module> module, so you
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher should also use <code>--enable-proxy</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable rule based URL manipulation provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable DSO capability provided by <module>mod_so</module>. This
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher module will be automatically enabled if you use the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>--enable-mods-shared</code> option.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the functionality to correct common URL misspellings, which
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov is provided by <module>mod_speling</module>.</dd>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov <dd>Enable support for SSL/TLS provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the generation of per-request unique ids, which is provided
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable user-session tracking provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-vhost-alias</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable mass virtual hosting provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="developermodules"><title>Modules for developers</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>The following modules are useful only for developers and testing
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher purposes and are disabled by default. Use the following options to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher enable them. If you are not sure whether you need one of these
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher modules, omit them.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- module doc needed -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the manipulation filter for buckets, which is provided by
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- module doc needed -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-case-filter</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the example uppercase conversion output filter support of
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- module doc needed -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-case-filter-in</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the example uppercase conversion input filter support of
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the ECHO server provided by
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dd>Enable the example and demo module
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- module doc needed -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-optional-fn-export</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the example for an optional function exporter, which is
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher provided by <code>mod_optional_fn_export</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- module doc needed -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-optional-fn-import</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the example for an optional function importer, which is
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher provided by <code>mod_optional_fn_import</code>.</dd>
e2ac9be4f293b96f3c8992f1171e44bc1da5cfcaMichal Zidek <!-- module doc needed -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-optional-hook-export</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Enable the example for an optional hook exporter, which is provided
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher by <code>mod_optional_hook_export</code>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- module doc needed -->
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dt><code>--enable-optional-hook-import</code></dt>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dd>Enable the example optional hook importer, which is provided by
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <code>mod_optional_hook_import</code>.</dd>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <section id="modules"><title>MPMs and third-party modules</title>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <p>To add the necessary Multi Processing Module and additional third-party
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher modules use the following options:</p>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dt><code>--with-module=<var>module-type</var>:<var>module-file</var>[,
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <var>module-type</var>:<var>module-file</var>]</code></dt>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dd><p>Add one or more third-party modules to the list of statically linked
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher modules. The module source file <code><var>module-file</var></code>
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov will be searched in the <code>modules/<var>module-type</var></code>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher subdirectory of your Apache HTTP server source tree. If it is not found
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher there <code>configure</code> is considering <var>module-file</var> to be
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher an absolute file path and tries to copy the source file into the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <var>module-type</var> subdirectory. If the subdirectory doesn't
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher exist it will be created and populated with a standard
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <p>This option is useful to add small external modules consisting of
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher one source file. For more complex modules you should read the
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher vendor's documentation.</p>
3d8a87081a6cd197acbd355b5a39111669ec2aa6Jakub Hrozek If you want to build a DSO module instead of a statically linked
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dd>Choose the process model for your server. You have to select
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher exactly one <a href="/mpm.html">Multi-Processing Module</a>.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher Otherwise the <a href="/mpm.html#defaults">default MPM</a> for
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher your operating system will be taken. Possible MPMs are
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>beos</module>, <module>leader</module>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <module>mpmt_os2</module>, <module>perchild</module>,
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <module>prefork</module>, <module>threadpool</module> and
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <section id="otheroptfeat"><title>Cumulative and other options</title>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dt><code>--enable-maintainer-mode</code></dt>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <dd>Turn on debugging and compile time warnings.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--enable-mods-shared=<var>MODULE-LIST</var></code></dt>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <p>Defines a list of modules to be enabled and build as dynamic
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher shared modules. This mean, these module have to be loaded
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher dynamically by using the <directive
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher module="mod_so">LoadModule</directive> directive.</p>
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <p><var>MODULE-LIST</var> is a space separated list of modulenames
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher enclosed by quotation marks. The module names are given without the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher preceding <code>mod_</code>. For example:</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher --enable-mods-shared='headers rewrite dav'
f5e22261a2ff95f2a61f4f199fffb8de79668110Stephen Gallagher <p>Additionally you can use the special keywords <code>all</code> and
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher --enable-mods-shared=most
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>will compile most modules and build them as DSO modules.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <!-- See <a href="/install/enabledmodules.html">Overview of
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher enabled modules</a> for further information. --></p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>--enable-mods-shared=all</code> does not actually build all
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher modules. To build all modules then, one might use:</p>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher --with-ldap \<br />
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher --enable-mods-shared="all ssl ldap cache proxy authn_alias mem_cache file_cache authnz_ldap charset_lite dav_lock disk_cache"
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd>This option behaves similar to <code>--enable-mods-shared</code>,
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher but will link the given modules statically. This mean, these modules
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher will always be present while running <program>httpd</program>. They need
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher not be loaded with <directive
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher module="mod_so">LoadModule</directive>.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>Allow IPv6 sockets to handle IPv4 connections.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--with-port=<var>PORT</var></code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>This defines the port on which <program>httpd</program> will listen.
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher This port number is used when generating the configuration file
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>httpd.conf</code>. The default is 80.</dd>
9b72b00ebcfd6225a4e139619c8e18d44a448f87Stephen Gallagher <dd>Define an alternative executable name. The default is
e2ac9be4f293b96f3c8992f1171e44bc1da5cfcaMichal Zidek <section id="packages"><title>Optional packages</title>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <p>These options are used to define optional packages.</p>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="generalpackages"><title>General syntax</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>Generally you can use the following syntax to define an optional
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dt><code>--with-<var>PACKAGE</var>[=<var>ARG</var>]</code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd>Use the package <var>PACKAGE</var>. The default value for
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dt><code>--without-<var>PACKAGE</var></code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd>Do not use the package <var>PACKAGE</var>. This is the same as
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <code>--with-<var>PACKAGE</var>=no</code>. This option is provided by
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <code>autoconf</code> but not very useful for the Apache HTTP
3d8a87081a6cd197acbd355b5a39111669ec2aa6Jakub Hrozek Server.</dd>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <!-- options not known are passed to packages?
a3c8390d19593b1e5277d95bfb4ab206d4785150Nikolai Kondrashov are there other important options for packages? -->
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <section id="packageopt"><title>Specific packages</title>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd>The <glossary ref="apr">Apache Portable Runtime</glossary> (APR)
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher is part of the httpd
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher source distribution and will automatically be build together with the
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher HTTP server. If you want to use an already installed APR instead you
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher have to tell <code>configure</code> the path to the
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <code>apr-config</code> script. You may set the absolute path and name
3d8a87081a6cd197acbd355b5a39111669ec2aa6Jakub Hrozek or the directory to the installed APR. <code>apr-config</code> must
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher exist within this directory or the subdirectory
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd>The Apache Portable Runtime Utilities (APU) are part of the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher httpd source distribution and will automatically be build
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher together with the HTTP server. If you want to use an already installed
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher APU instead you have to tell <code>configure</code> the path to the
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <code>apu-config</code> script. You may set the absolute path and name
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher or the directory to the installed APU. <code>apu-config</code> must
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher exists within this directory or the subdirectory
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dt><code>--with-ssl=<var>DIR</var></code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd>If <module>mod_ssl</module> has been enabled <code>configure</code>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher searches for an installed OpenSSL. You can set the directory path
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dt><code>--with-z=<var>DIR</var></code></dt>
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <dd><code>configure</code> searches automatically for an installed
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <code>zlib</code> library if your source configuration requires one
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher (e.g., when <module>mod_deflate</module> is enabled). You can set the
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher directory path to the compression library instead.</dd>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <p>Several features of the Apache HTTP Server, including
c1fcc832ccfc237caac8b99be238cf2d598f908cStephen Gallagher <module>mod_authn_dbm</module> and <module>mod_rewrite</module>'s DBM
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <directive module="mod_rewrite">RewriteMap</directive> use simple
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher key/value databases for quick lookups of information. SDBM is included
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher in the APU, so this database is always available. If you would like to
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher use other database types, use the following options to enable
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dt><code>--with-gdbm[=<var>path</var>]</code></dt>
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher <dd>If no <var>path</var> is specified, <code>configure</code> will
e134a6af42102c8d865e82bf89e0b8c5a40fb5faStephen Gallagher search for the include files and libraries of a GNU DBM