<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>configure - Configure the source tree</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/programs/configure.html" title="English"> en </a> |
-<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
<p>The <code>configure</code> script configures the source tree
<p>This script, included in the root directory of the source
distribution, is for compilation on Unix and Unix-like systems
- only. For other platforms, see the <a href="../platform/">platform</a> documentation.</p>
+ only. For other platforms, see the <a href="../platform/">platform</a> documentation.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
</dl>
- <h3><a name="installationdirectories" id="installationdirectories">Installation
+ <h3><a name="installationdirectories" id="installationdirectories">Installation
directories</a></h3>
<p>These options define the installation directory. The installation
<h4><a name="directoryfinetuning" id="directoryfinetuning">Fine tuning of the installation
directories</a></h4>
-
+
<p>For better control of the installation directories, use the options
below. Please note that the directory defaults are set by
<code>autoconf</code> and are overwritten by the corresponding layout
By default <code>infodir</code> is set to
<code><var>PREFIX</var>/info</code>. This option is currently
unused.</dd>
-
+
<dt><code>--libdir=<var>DIR</var></code></dt>
<dd>Install object code libraries in <var>DIR</var>. By default
<code>libdir</code> is set to
<code>autoconf</code> and currently unused.</dd>
<dt><code>--mandir=<var>DIR</var></code></dt>
- <dd>Install the man documentation in <var>DIR</var>. By default
+ <dd>Install the man documentation in <var>DIR</var>. By default
<code>mandir</code> is set to
<code><var>EPREFIX</var>/man</code>.</dd>
-
+
<dt><code>--oldincludedir=<var>DIR</var></code></dt>
<dd>Install C header files for non-gcc in <var>DIR</var>.
By default <code>oldincludedir</code> is set to
<code>/usr/include</code>. This option is offered by
<code>autoconf</code> and currently unused.</dd>
-
+
<dt><code>--sbindir=<var>DIR</var></code></dt>
<dd>Install the system administrator executables in <var>DIR</var>.
Those are server programs like <code class="program"><a href="../programs/httpd.html">httpd</a></code>,
<dd>Install read-only single-machine data like the server configuration
files <code>httpd.conf</code>, <code>mime.types</code>, etc. in
<var>DIR</var>. By default <code>sysconfdir</code> is set to
- <code><var>PREFIX</var>/etc</code>.</dd>
- </dl>
+ <code><var>PREFIX</var>/conf</code>.</dd>
+ </dl>
-
+
<h3><a name="systemtypes" id="systemtypes">System types</a></h3>
<p>These options are used to cross-compile the Apache HTTP Server to run on
<code>--enable-<var>FEATURE</var>=no</code>.</dd>
<dt><code>--enable-<var>FEATURE</var>[=<var>ARG</var>]</code></dt>
- <dd>Include <var>FEATURE</var>. The default value for <var>ARG</var>
+ <dd>Include <var>FEATURE</var>. The default value for <var>ARG</var>
is <code>yes</code>.</dd>
<dt><code>--enable-<var>MODULE</var>=shared</code></dt>
- <dd>The corresponding module will be build as DSO module.</dd>
+ <dd>The corresponding module will be build as DSO module.
+ By default enabled modules are linked dynamically.</dd>
<dt><code>--enable-<var>MODULE</var>=static</code></dt>
- <dd>By default enabled modules are linked statically. You can force
- this explicitly.</dd>
+ <dd>The corresponding module will be linked statically.</dd>
</dl>
<div class="note"><h3>Note</h3>
<h4><a name="enabledmodules" id="enabledmodules">Modules enabled by default</a></h4>
<p>Some modules are compiled by default and have to be disabled
- explicitly. Use the following options to remove discrete modules from
- the compilation process.</p>
-
+ explicitly or by using the keywords <code>few</code> or
+ <code>none</code> (see <code>--enable-modules</code>,
+ <code>--enable-mods-shared</code> and <code>--enable-mods-static</code>
+ below for further explanation) to be removed. The following options remove
+ individual modules from the compilation process.</p>
+
<dl>
<dt><code>--disable-actions</code></dt>
<dd>Disable action triggering on requests, which is provided by
<dt><code>--disable-auth</code></dt>
<dd>Disable user-based access control provided by
- <code class="module"><a href="../mod/mod_auth.html">mod_auth</a></code>. This module provides for HTTP Basic
+ <code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code>. This module provides for HTTP Basic
Authentication, where the usernames and passwords are stored in
plain text files.</dd>
<dt><code>--disable-access</code></dt>
<dd>Disable host-based access control provided by
- <code class="module"><a href="../mod/mod_access.html">mod_access</a></code>.</dd>
+ <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code>.</dd>
<dt><code>--disable-cgi</code></dt>
<dd><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code>, which provides support for CGI scripts,
is enabled by default when using a non-threaded MPM. Use this
option to disable CGI support.</dd>
-
+
<dt><code>--disable-cgid</code></dt>
- <dd>When using the threaded MPMs <code class="module"><a href="../mod/worker.html">worker</a></code> or
- <code class="module"><a href="../mod/perchild.html">perchild</a></code> support for CGI scripts is provided by
- <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code> by default. To disable CGI support use
- this option.</dd>
+ <dd>When using the threaded MPM <code class="module"><a href="../mod/worker.html">worker</a></code>,
+ support for CGI scripts is provided by <code class="module"><a href="../mod/mod_cgid.html">mod_cgid</a></code>
+ by default. To disable CGI support use this option.</dd>
<dt><code>--disable-charset-lite</code></dt>
<dd>Disable character set translation provided by
another protocol module instead. <strong>Don't disable this
module unless you are really sure what you are doing.</strong>
<br />
- Note: This module will always be linked statically.</dd>
+ Note: This module will always be linked statically.</dd>
<dt><code>--disable-imagemap</code></dt>
<dd>Disable support for server based imagemaps, which provided by
<h4><a name="disabledmodules" id="disabledmodules">Modules, disabled by default</a></h4>
- <p>Some modules are compiled by default and have to be enabled
+ <p>Some modules are not compiled by default and have to be enabled
explicitly or by using the keywords <code>most</code> or
- <code>all</code> (see <code>--enable-mods-shared</code> below for
- further explanation) to be available. Therefore use the options
- below.</p>
+ <code>all</code> (see <code>--enable-modules</code>,
+ <code>--enable-mods-shared</code> and <code>--enable-mods-static</code>
+ below for further explanation) to be available. The following options
+ add individual modules to the compilation process.</p>
<dl>
- <dt><code>--enable-auth-anon</code></dt>
+ <dt><code>--enable-authn-anon</code></dt>
<dd>Enable anonymous user access provided by
- <code class="module"><a href="../mod/mod_auth_anon.html">mod_auth_anon</a></code>.</dd>
+ <code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code>.</dd>
- <dt><code>--enable-auth-dbm</code></dt>
- <dd><code class="module"><a href="../mod/mod_auth_dbm.html">mod_auth_dbm</a></code> provides for HTTP Basic
+ <dt><code>--enable-authn-dbm</code></dt>
+ <dd><code class="module"><a href="../mod/mod_authn_dbm.html">mod_authn_dbm</a></code> provides for HTTP Basic
Authentication, where the usernames and passwords are stored in DBM
type database files. Use this option to enable the module.</dd>
+ <dt><code>--enable-authz-dbm</code></dt>
+ <dd><code class="module"><a href="../mod/mod_authz_dbm.html">mod_authz_dbm</a></code> provides for HTTP Basic
+ Authorization, where the usernames and groups are stored in DBM
+ type database files. Use this option to enable the module.</dd>
+
<dt><code>--enable-auth-digest</code></dt>
<dd>Enable RFC2617 Digest authentication provided by
<code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code>. This module uses plain text files
<dt><code>--enable-authnz-ldap</code></dt>
<dd>Enable LDAP based authentication provided by
<code class="module"><a href="../mod/mod_authnz_ldap.html">mod_authnz_ldap</a></code>.</dd>
-
+
<dt><code>--enable-cache</code></dt>
<dd>Enable dynamic file caching provided by
<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>. This experimental module may be
interesting for servers with high load or caching proxy servers. At
least one storage management module (e.g.
- <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code> or <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code>)
- is also necessary.</dd>
+ <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>) is also necessary.</dd>
<dt><code>--enable-cern-meta</code></dt>
<dd>Enable the CERN-type meta files support provided by
<dd>Enable DAV support for filesystem resources, which is provided by
<code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. This module is a provider for the
<code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> module, so you should also use
- <code>--enable-dav</code>.</dd>
+ <code>--enable-dav</code>.</dd>
<dt><code>--enable-dav-lock</code></dt>
<dd>Enable <code class="module"><a href="../mod/mod_dav_lock.html">mod_dav_lock</a></code> which provides generic DAV
<code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>.</dd>
<dt><code>--enable-expires</code></dt>
- <dd>Enable Expires header control provided by
+ <dd>Enable <code>Expires</code> header control provided by
<code class="module"><a href="../mod/mod_expires.html">mod_expires</a></code>.</dd>
<dt><code>--enable-ext-filter</code></dt>
<dd>Enable logging of input and output bytes including headers provided
by <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code>.</dd>
- <dt><code>--enable-mem-cache</code></dt>
- <dd>Enable memory caching provided by
- <code class="module"><a href="../mod/mod_mem_cache.html">mod_mem_cache</a></code>.</dd>
-
- <dt><code>--enable-mime-magic</code></dt>
+ <dt><code>--enable-mime-magic</code></dt>
<dd>Enable
automatical determining of <a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">MIME
types</a>, which is provided by
<dt><code>--enable-so</code></dt>
<dd>Enable DSO capability provided by <code class="module"><a href="../mod/mod_so.html">mod_so</a></code>. This
- module will be automatically enabled if you use the
- <code>--enable-mods-shared</code> option.</dd>
+ module will be automatically enabled unless you build
+ all modules statically.</dd>
<dt><code>--enable-speling</code></dt>
<dd>Enable the functionality to correct common URL misspellings, which
<dt><code>--enable-optional-fn-export</code></dt>
<dd>Enable the example for an optional function exporter, which is
- provided by <code>mod_optional_fn_export</code>.</dd>
+ provided by <code>mod_optional_fn_export</code>.</dd>
<dt><code>--enable-optional-fn-import</code></dt>
</dl>
- <h4><a name="modules" id="modules">MPMs and third-party modules</a></h4>
- <p>To add the necessary Multi Processing Module and additional third-party
- modules use the following options:</p>
+ <h4><a name="mpms" id="mpms">Multi-Processing Modules</a></h4>
+ <p><a href="../mpm.html">Multi-Processing Modules</a>, or MPMs, implement
+ the basic behavior of the server. A single MPM must be active in order
+ for the server to function. The list of available MPMs appears on the
+ <a href="../mod/">module index page</a>.</p>
+
+ <p>MPMs can be built as DSOs for dynamic loading or statically linked with
+ the server, and are enabled using the following options:</p>
+
+ <dl>
+ <dt><code>--with-mpm=MPM</code></dt>
+ <dd>
+ <p>Choose the default MPM for your server. If MPMs are built as DSO
+ modules (see <code>--enable-mpms-shared</code>), this directive
+ selects the MPM which will be loaded in the default configuration
+ file. Otherwise, this directive selects the only available MPM,
+ which will be statically linked into the server.</p>
+ <p>If this option is omitted, the <a href="../mpm.html#defaults">default
+ MPM</a> for your operating system will be used.</p>
+ </dd>
+
+ <dt><code>--enable-mpms-shared=<var>MPM-LIST</var></code></dt>
+ <dd>
+ <p>Enable a list of MPMs as dynamic shared modules. One of these
+ modules must be loaded dynamically using the
+ <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</p>
+ <p><var>MPM-LIST</var> is a space-separated list of MPM names
+ enclosed by quotation marks. For example:</p>
+ <div class="example"><p><code>
+ --enable-mpms-shared='prefork worker'
+ </code></p></div>
+ <p>Additionally you can use the special keyword <code>all</code>,
+ which will select all MPMs which support dynamic loading on the
+ current platform and build them as DSO modules. For example:</p>
+ <div class="example"><p><code>
+ --enable-mpms-shared=all
+ </code></p></div>
+ </dd>
+ </dl>
+
+
+ <h4><a name="modules" id="modules">Third-party modules</a></h4>
+ <p>To add additional third-party modules use the following options:</p>
<dl>
<dt><code>--with-module=<var>module-type</var>:<var>module-file</var>[,
If you want to build a DSO module instead of a statically linked
use <code class="program"><a href="../programs/apxs.html">apxs</a></code>.</div>
</dd>
-
- <dt><code>--with-mpm=MPM</code></dt>
- <dd>Choose the process model for your server. You have to select
- exactly one <a href="../mpm.html">Multi-Processing Module</a>.
- Otherwise the <a href="../mpm.html#defaults">default MPM</a> for
- your operating system will be taken. Possible MPMs are
- <code class="module"><a href="../mod/beos.html">beos</a></code>, <code class="module"><a href="../mod/leader.html">leader</a></code>,
- <code class="module"><a href="../mod/mpmt_os2.html">mpmt_os2</a></code>, <code class="module"><a href="../mod/perchild.html">perchild</a></code>,
- <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/threadpool.html">threadpool</a></code> and
- <code class="module"><a href="../mod/worker.html">worker</a></code>.</dd>
</dl>
<div class="example"><p><code>
--enable-mods-shared='headers rewrite dav'
</code></p></div>
- <p>Additionally you can use the special keywords <code>all</code> and
- <code>most</code>. For example,</p>
+ <p>Additionally you can use the special keywords <code>all</code>,
+ <code>most</code> and <code>few</code>. For example,</p>
<div class="example"><p><code>
--enable-mods-shared=most
</code></p></div>
- <p>will compile most modules and build them as DSO modules.
- </p>
+ <p>will compile most modules and build them as DSO modules,</p>
+ <div class="example"><p><code>
+ --enable-mods-shared=few
+ </code></p></div>
+ <p>will only compile a very basic set of modules.</p>
+ <p>The default set is <code>most</code>.</p>
+
<p><strong>Caveat:</strong>
<code>--enable-mods-shared=all</code> does not actually build all
modules. To build all modules then, one might use:</p>
./configure \<br />
<span class="indent">
--with-ldap \<br />
- --enable-mods-shared="all ssl ldap cache proxy authn_alias mem_cache file_cache authnz_ldap charset_lite dav_lock disk_cache"
+ --enable-mods-shared="all ssl ldap cache proxy authn_alias file_cache authnz_ldap charset_lite dav_lock disk_cache"
</span>
</code></p></div>
</dd>
- <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
- <dd>This option behaves similar to <code>--enable-mods-shared</code>,
+ <dt><code>--enable-mods-static=<var>MODULE-LIST</var></code></dt>
+ <dd>This option behaves similar to <code>--enable-mods-shared</code>,
but will link the given modules statically. This mean, these modules
will always be present while running <code class="program"><a href="../programs/httpd.html">httpd</a></code>. They need
not be loaded with <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code>.</dd>
+ <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
+ <dd>This option behaves like to <code>--enable-mods-shared</code>,
+ and will also link the given modules dynamically. The special
+ keyword <code>none</code> disables the build of all modules.</dd>
+
<dt><code>--enable-v4-mapped</code></dt>
<dd>Allow IPv6 sockets to handle IPv4 connections.</dd>
<dl>
<dt><code>--with-<var>PACKAGE</var>[=<var>ARG</var>]</code></dt>
<dd>Use the package <var>PACKAGE</var>. The default value for
- <var>ARG</var> is<code>yes</code>.</dd>
+ <var>ARG</var> is <code>yes</code>.</dd>
<dt><code>--without-<var>PACKAGE</var></code></dt>
<dd>Do not use the package <var>PACKAGE</var>. This is the same as
<h4><a name="packageopt" id="packageopt">Specific packages</a></h4>
<dl>
<dt><code>--with-apr=<var>DIR</var>|<var>FILE</var></code></dt>
- <dd>The <a class="glossarylink" href="../glossary.html#apr" title="see glossary">Apache Portable Runtime</a> (APR)
+ <dd>The <a class="glossarylink" href="../glossary.html#apr" title="see glossary">Apache Portable Runtime</a> (APR)
is part of the httpd
source distribution and will automatically be build together with the
HTTP server. If you want to use an already installed APR instead you
or the directory to the installed APR. <code>apr-config</code> must
exist within this directory or the subdirectory
<code>bin</code>.</dd>
-
+
<dt><code>--with-apr-util=<var>DIR</var>|<var>FILE</var></code></dt>
<dd>The Apache Portable Runtime Utilities (APU) are part of the
httpd source distribution and will automatically be build
APU instead you have to tell <code>configure</code> the path to the
<code>apu-config</code> script. You may set the absolute path and name
or the directory to the installed APU. <code>apu-config</code> must
- exists within this directory or the subdirectory
+ exist within this directory or the subdirectory
<code>bin</code>.</dd>
<dt><code>--with-ssl=<var>DIR</var></code></dt>
in the APU, so this database is always available. If you would like to
use other database types, use the following options to enable
them:</p>
-
+
<dl>
<dt><code>--with-gdbm[=<var>path</var>]</code></dt>
<dd>If no <var>path</var> is specified, <code>configure</code> will
<code><var>path</var>/include</code> for the relevant files.
Finally, the <var>path</var> may specify specific include and
library paths separated by a colon.</dd>
-
+
<dt><code>--with-ndbm[=<var>path</var>]</code></dt>
- <dd>Like <code>--with-gdbm</code>, bur searches for a New DBM
+ <dd>Like <code>--with-gdbm</code>, but searches for a New DBM
installation.</dd>
-
+
<dt><code>--with-berkeley-db[=<var>path</var>]</code></dt>
<dd>Like <code>--with-gdbm</code>, but searches for a Berkeley DB
installation.</dd>
</div>
-
+
<h3><a name="supportopt" id="supportopt">Options for support programs</a></h3>
<dl>
<dt><code>--enable-static-support</code></dt>
uid and gid for spawned processes. <strong>Do not use this
option unless you understand all the security implications of
running a suid binary on your server.</strong> Further options
- to configure <code class="program"><a href="../programs/suexec.html">suexec</a></code> are described <a href="#suexec">below</a>.</dd> </dl>
+ to configure <code class="program"><a href="../programs/suexec.html">suexec</a></code> are described <a href="#suexec">below</a>.</dd>
+ </dl>
<p>It is possible to create a statically linked binary of a single
support program by using the following options:</p>
<dt><code>--enable-static-htdigest</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/htdigest.html">htdigest</a></code>.</dd>
-
+
<dt><code>--enable-static-htpasswd</code></dt>
<dd>Build a statically linked version of <code class="program"><a href="../programs/htpasswd.html">htpasswd</a></code>.</dd>
<dd>Build a statically linked version of <code class="program"><a href="../programs/rotatelogs.html">rotatelogs</a></code>.</dd>
</dl>
- <h4><a name="suexec" id="suexec">suexec configuration options</a></h4>
+ <h4><a name="suexec" id="suexec"><code>suexec</code> configuration options</a></h4>
+
<p>The following options are used to fine tune the behavior of <code class="program"><a href="../programs/suexec.html">suexec</a></code>. See <a href="suexec.html#install">Configuring and installing suEXEC</a>
for further information.</p>
<dl>
<dt><code>--with-suexec-bin</code></dt>
- <dd>This defines the path to suexec binary. Default is
- <code>--sbindir</code> (see <a href="directoryfinetuning">Fine
- tuning of installation directories</a>).</dd>
+ <dd>This defines the path to <code class="program"><a href="../programs/suexec.html">suexec</a></code> binary.
+ Default is <code>--sbindir</code> (see <a href="#directoryfinetuning">Fine tuning of installation directories</a>).</dd>
<dt><code>--with-suexec-caller</code></dt>
<dd>This defines the user allowed to call <code class="program"><a href="../programs/suexec.html">suexec</a></code>.
- It should be the same as the user under which <code class="program"><a href="../programs/httpd.html">httpd</a></code>
- normally runs.</dd>
+ It should be the same as the user under which
+ <code class="program"><a href="../programs/httpd.html">httpd</a></code> normally runs.</dd>
<dt><code>--with-suexec-docroot</code></dt>
<dd>This defines the directory tree under which <code class="program"><a href="../programs/suexec.html">suexec</a></code> access is allowed for executables. Default value is
<dt><code>LDFLAGS</code></dt>
<dd>Set linker flags, e.g. <code>-L<var>libdir</var></code> if you have
- libraries in a nonstandard directory <var>libdir</var>.</dd>
+ libraries in a nonstandard directory <var>libdir</var>.</dd>
</dl>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/programs/configure.html" title="English"> en </a> |
-<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+<a href="../ko/programs/configure.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/programs/configure.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
-<p class="apache">Copyright 20
08 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="apache">Copyright 20
10 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
</body></html>
\ No newline at end of file
projects / apache / blobdiff