</div>
-
- <h4><a name="enabledmodules" id="enabledmodules">Modules enabled by default</a></h4>
+ <h4><a name="choosemodules" id="choosemodules">Choosing modules to compile</a></h4>
<p>Some modules are compiled by default and have to be disabled
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
- <code class="module"><a href="../mod/mod_actions.html">mod_actions</a></code>.</dd>
-
- <dt><code>--disable-alias</code></dt>
- <dd>Disable the mapping of requests to different parts of the
- filesystem, which is provided by <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>.</dd>
-
- <dt><code>--disable-asis</code></dt>
- <dd>Disable support for as-is filetypes, which is provided by
- <code class="module"><a href="../mod/mod_asis.html">mod_asis</a></code>.</dd>
-
- <dt><code>--disable-auth</code></dt>
- <dd>Disable user-based access control provided by
- <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-autoindex</code></dt>
- <dd>Disable the directory listing functionality provided by
- <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code>.</dd>
-
- <dt><code>--disable-access</code></dt>
- <dd>Disable host-based access control provided by
- <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 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
- <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>. This module will be installed by
- default only on EBCDIC systems.</dd>
-
- <dt><code>--disable-dir</code></dt>
- <dd>Disable directory request handling provided by
- <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>.</dd>
-
- <dt><code>--disable-env</code></dt>
- <dd>Disable setting and clearing of environment variables, which is
- provided by <code class="module"><a href="../mod/mod_env.html">mod_env</a></code>.</dd>
-
-
- <dt><code>--disable-http</code></dt>
- <dd>Disable the HTTP protocol handling. The <code>http</code>
- module is a basic one, enabling the server to function as an
- HTTP server. It is only useful to disable it if you want to use
- 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>
-
- <dt><code>--disable-imagemap</code></dt>
- <dd>Disable support for server based imagemaps, which provided by
- <code class="module"><a href="../mod/mod_imagemap.html">mod_imagemap</a></code>.</dd>
-
- <dt><code>--disable-include</code></dt>
- <dd>Disable Server Side Includes provided by
- <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>.</dd>
-
- <dt><code>--disable-log-config</code></dt>
- <dd>Disable the logging configuration provided by
- <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>. You won't be able to log requests
- to the server without this module.</dd>
-
- <dt><code>--disable-mime</code></dt>
- <dd><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code> associates the requested
- filename's extensions with the file's behavior and content
- (<a class="glossarylink" href="../glossary.html#mime-type" title="see glossary">mime-type</a>, language, character set and
- encoding). Disabling this module is normally not recommended.</dd>
-
- <dt><code>--disable-negotiation</code></dt>
- <dd>Disable content negotiation provided by
- <code class="module"><a href="../mod/mod_negotiation.html">mod_negotiation</a></code>.</dd>
-
- <dt><code>--disable-setenvif</code></dt>
- <dd>Disable support for basing environment variables on headers,
- which is provided by <code class="module"><a href="../mod/mod_setenvif.html">mod_setenvif</a></code>.</dd>
-
- <dt><code>--disable-status</code></dt>
- <dd>Disable the process/thread monitoring, which is provided by
- <code class="module"><a href="../mod/mod_status.html">mod_status</a></code>.</dd>
-
- <dt><code>--disable-userdir</code></dt>
- <dd>Disable the mapping of requests to user-specific directories,
- which is provided by <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</dd>
- </dl>
-
+ below for further explanation) to be removed.</p>
- <h4><a name="disabledmodules" id="disabledmodules">Modules, disabled by default</a></h4>
- <p>Some modules are not compiled by default and have to be enabled
+ <p>Other 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-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>
- <dd>Enable anonymous user access provided by
- <code class="module"><a href="../mod/mod_authn_anon.html">mod_authn_anon</a></code>.</dd>
-
- <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
- to store the credentials.</dd>
-
- <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>) is also necessary.</dd>
-
- <dt><code>--enable-cern-meta</code></dt>
- <dd>Enable the CERN-type meta files support provided by
- <code class="module"><a href="../mod/mod_cern_meta.html">mod_cern_meta</a></code>.</dd>
-
- <dt><code>--enable-charset-lite</code></dt>
- <dd>Enable character set translation provided by
- <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>. This module will be installed by
- default only on EBCDIC systems. On other systems, you have to enable
- it.</dd>
-
- <dt><code>--enable-dav</code></dt>
- <dd>Enable the WebDAV protocol handling provided by
- <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code>. Support for filesystem resources is
- provided by the separate module <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code>. This
- module is also automatically enabled with
- <code>--enable-dav</code>.<br />
- Note: <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> can only be used together with the
- <code>http</code> protocol module.</dd>
-
- <dt><code>--enable-dav-fs</code></dt>
- <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>
-
- <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
- locking support for backend modules. This module needs at least
- <code class="module"><a href="../mod/mod_dav.html">mod_dav</a></code> to function, so you should also use
- <code>--enable-dav</code>.</dd>
-
- <dt><code>--enable-deflate</code></dt>
- <dd>Enable deflate transfer encoding provided by
- <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</dd>
-
- <dt><code>--enable-disk-cache</code></dt>
- <dd>Enable disk caching provided by
- <code class="module"><a href="../mod/mod_disk_cache.html">mod_disk_cache</a></code>.</dd>
-
- <dt><code>--enable-expires</code></dt>
- <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 the external filter support provided by
- <code class="module"><a href="../mod/mod_ext_filter.html">mod_ext_filter</a></code>.</dd>
-
- <dt><code>--enable-file-cache</code></dt>
- <dd>Enable the file cache provided by
- <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code>.</dd>
-
- <dt><code>--enable-headers</code></dt>
- <dd>Enable control of HTTP headers provided by
- <code class="module"><a href="../mod/mod_headers.html">mod_headers</a></code>.</dd>
-
- <dt><code>--enable-info</code></dt>
- <dd>Enable the server information provided by
- <code class="module"><a href="../mod/mod_info.html">mod_info</a></code>.</dd>
-
- <dt><code>--enable-ldap</code></dt>
- <dd>Enable LDAP caching and connection pooling services provided by
- <code class="module"><a href="../mod/mod_ldap.html">mod_ldap</a></code>.</dd>
-
- <dt><code>--enable-logio</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-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
- <code class="module"><a href="../mod/mod_mime_magic.html">mod_mime_magic</a></code>.</dd>
-
- <dt><code>--enable-isapi</code></dt>
- <dd>Enable the isapi extension support provided by
- <code class="module"><a href="../mod/mod_isapi.html">mod_isapi</a></code>.</dd>
-
- <dt><code>--enable-proxy</code></dt>
- <dd>Enable the proxy/gateway functionality provided by
- <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. The proxying capabilities for
- <code>AJP13</code>, <code>CONNECT</code>, <code>FTP</code>,
- <code>HTTP</code> and the balancer are provided by the separate
- modules <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>,
- <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code>, <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>,
- <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> and
- <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>.
- These five modules are also automatically enabled with
- <code>--enable-proxy</code>.</dd>
-
- <dt><code>--enable-proxy-ajp</code></dt>
- <dd>Enable proxy support for <code>AJP13 (Apache JServ Protocol 1.3)</code>
- request handling, which is provided by <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>.
- This module is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module,
- so you should also use <code>--enable-proxy</code>.</dd>
-
- <dt><code>--enable-proxy-balancer</code></dt>
- <dd>Enable load balancing support for the <code>AJP13</code>,
- <code>FTP</code> and <code>HTTP</code> protocols, which is provided by
- <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>. This module is an extension for the
- <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you should also use
- <code>--enable-proxy</code>.</dd>
-
- <dt><code>--enable-proxy-connect</code></dt>
- <dd>Enable proxy support for <code>CONNECT</code> request handling,
- which is provided by <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code>. This module
- is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you
- should also use <code>--enable-proxy</code>.</dd>
-
- <dt><code>--enable-proxy-ftp</code></dt>
- <dd>Enable proxy support for <code>FTP</code> requests, which is
- provided by <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>. This module
- is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you
- should also use <code>--enable-proxy</code>.</dd>
-
- <dt><code>--enable-proxy-http</code></dt>
- <dd>Enable proxy support for <code>HTTP</code> requests, which is
- provided by <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>. This module
- is an extension for the <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> module, so you
- should also use <code>--enable-proxy</code>.</dd>
-
- <dt><code>--enable-rewrite</code></dt>
- <dd>Enable rule based URL manipulation provided by
- <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</dd>
-
- <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 unless you build
- all modules statically.</dd>
-
- <dt><code>--enable-speling</code></dt>
- <dd>Enable the functionality to correct common URL misspellings, which
- is provided by <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code>.</dd>
-
- <dt><code>--enable-ssl</code></dt>
- <dd>Enable support for SSL/TLS provided by
- <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code>.</dd>
-
- <dt><code>--enable-unique-id</code></dt>
- <dd>Enable the generation of per-request unique ids, which is provided
- by <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code>.</dd>
-
- <dt><code>--enable-usertrack</code></dt>
- <dd>Enable user-session tracking provided by
- <code class="module"><a href="../mod/mod_usertrack.html">mod_usertrack</a></code>.</dd>
-
- <dt><code>--enable-vhost-alias</code></dt>
- <dd>Enable mass virtual hosting provided by
- <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</dd>
- </dl>
-
-
- <h4><a name="developermodules" id="developermodules">Modules for developers</a></h4>
- <p>The following modules are useful only for developers and testing
- purposes and are disabled by default. Use the following options to
- enable them. If you are not sure whether you need one of these
- modules, omit them.</p>
-
- <dl>
-
- <dt><code>--enable-bucketeer</code></dt>
- <dd>Enable the manipulation filter for buckets, which is provided by
- <code>mod_bucketeer</code>.</dd>
-
-
- <dt><code>--enable-case-filter</code></dt>
- <dd>Enable the example uppercase conversion output filter support of
- <code>mod_case_filter</code>.</dd>
-
-
- <dt><code>--enable-case-filter-in</code></dt>
- <dd>Enable the example uppercase conversion input filter support of
- <code>mod_case_filter_in</code>.</dd>
-
- <dt><code>--enable-echo</code></dt>
- <dd>Enable the ECHO server provided by
- <code class="module"><a href="../mod/mod_echo.html">mod_echo</a></code>.</dd>
-
- <dt><code>--enable-example</code></dt>
- <dd>Enable the example and demo module
- <code class="module"><a href="../mod/mod_example.html">mod_example</a></code>.</dd>
-
-
- <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>
-
-
- <dt><code>--enable-optional-fn-import</code></dt>
- <dd>Enable the example for an optional function importer, which is
- provided by <code>mod_optional_fn_import</code>.</dd>
-
-
- <dt><code>--enable-optional-hook-export</code></dt>
- <dd>Enable the example for an optional hook exporter, which is provided
- by <code>mod_optional_hook_export</code>.</dd>
-
-
- <dt><code>--enable-optional-hook-import</code></dt>
- <dd>Enable the example optional hook importer, which is provided by
- <code>mod_optional_hook_import</code>.</dd>
- </dl>
+ <code>all</code> to be available.</p>
+
+ <p>To find out which modules are compiled by default, run
+ <code>./configure -h</code> or <code>./configure --help</code>
+ and look under <code>Optional Features</code>. Suppose you
+ are interested in <code class="module"><a href="../mod/mod_example1.html">mod_example1</a></code> and
+ <code class="module"><a href="../mod/mod_example2.html">mod_example2</a></code>, and you
+ see this:</p>
+
+ <div class="example"><pre>Optional Features:
+ ...
+ --disable-example1 example module 1
+ --enable-example2 example module 2
+ ...</pre></div>
+
+ <p>Then <code>mod_example1</code> is enabled by default,
+ and you would use <code>--disable-example1</code> to not
+ compile it. <code>mod_example2</code> is disabled by
+ default, and you would use <code>--enable-example2</code>
+ to compile it.</p>
<h4><a name="mpms" id="mpms">Multi-Processing Modules</a></h4>
projects / apache / commitdiff