<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>
+ <code><var>PREFIX</var>/conf</code>.</dd>
</dl>
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>
<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,
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
<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-authn-anon</code></dt>
<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
</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>
</code></p></div>
</dd>
- <dt><code>--enable-modules=<var>MODULE-LIST</var></code></dt>
+ <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>
<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
09 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