From: Daniel Earl Poirier Date: Tue, 9 Nov 2010 15:40:44 +0000 (+0000) Subject: Remove out-of-date details about which modules are enabled by default X-Git-Tag: 2.3.9~70 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e62f32eeeea88f5b66609e21fdf6f0cc03d49a54;p=thirdparty%2Fapache%2Fhttpd.git Remove out-of-date details about which modules are enabled by default from the documentation, in favor of suggesting getting the up-to-date information by running ./configure -h. The special cases previously documented here (such as, this module depends on this other module, or you probably don't want this module unless you're a developer), have had that information added to the output of configure -h in r1029814. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1033032 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/programs/configure.xml b/docs/manual/programs/configure.xml index f05f2f9cc1c..e58af489357 100644 --- a/docs/manual/programs/configure.xml +++ b/docs/manual/programs/configure.xml @@ -288,353 +288,35 @@ - -
Modules enabled by default +
Choosing modules to compile

Some modules are compiled by default and have to be disabled explicitly or by using the keywords few or none (see --enable-modules, --enable-mods-shared and --enable-mods-static - below for further explanation) to be removed. The following options remove - individual modules from the compilation process.

+ below for further explanation) to be removed.

-
-
--disable-actions
-
Disable action triggering on requests, which is provided by - mod_actions.
- -
--disable-alias
-
Disable the mapping of requests to different parts of the - filesystem, which is provided by mod_alias.
- -
--disable-asis
-
Disable support for as-is filetypes, which is provided by - mod_asis.
- -
--disable-auth
-
Disable user-based access control provided by - mod_authn_file. This module provides for HTTP Basic - Authentication, where the usernames and passwords are stored in - plain text files.
- -
--disable-autoindex
-
Disable the directory listing functionality provided by - mod_autoindex.
- -
--disable-access
-
Disable host-based access control provided by - mod_authz_host.
- -
--disable-cgi
-
mod_cgi, which provides support for CGI scripts, - is enabled by default when using a non-threaded MPM. Use this - option to disable CGI support.
- -
--disable-cgid
-
When using the threaded MPM worker, - support for CGI scripts is provided by mod_cgid - by default. To disable CGI support use this option.
- -
--disable-charset-lite
-
Disable character set translation provided by - mod_charset_lite. This module will be installed by - default only on EBCDIC systems.
- -
--disable-dir
-
Disable directory request handling provided by - mod_dir.
- -
--disable-env
-
Disable setting and clearing of environment variables, which is - provided by mod_env.
- - -
--disable-http
-
Disable the HTTP protocol handling. The http - 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. Don't disable this - module unless you are really sure what you are doing. -
- Note: This module will always be linked statically.
- -
--disable-imagemap
-
Disable support for server based imagemaps, which provided by - mod_imagemap.
- -
--disable-include
-
Disable Server Side Includes provided by - mod_include.
- -
--disable-log-config
-
Disable the logging configuration provided by - mod_log_config. You won't be able to log requests - to the server without this module.
- -
--disable-mime
-
mod_mime associates the requested - filename's extensions with the file's behavior and content - (mime-type, language, character set and - encoding). Disabling this module is normally not recommended.
- -
--disable-negotiation
-
Disable content negotiation provided by - mod_negotiation.
- -
--disable-setenvif
-
Disable support for basing environment variables on headers, - which is provided by mod_setenvif.
- -
--disable-status
-
Disable the process/thread monitoring, which is provided by - mod_status.
- -
--disable-userdir
-
Disable the mapping of requests to user-specific directories, - which is provided by mod_userdir.
-
-
- -
Modules, disabled by default -

Some modules are not compiled by default and have to be enabled +

Other modules are not compiled by default and have to be enabled explicitly or by using the keywords most or - all (see --enable-modules, - --enable-mods-shared and --enable-mods-static - below for further explanation) to be available. The following options - add individual modules to the compilation process.

- -
-
--enable-authn-anon
-
Enable anonymous user access provided by - mod_authn_anon.
- -
--enable-authn-dbm
-
mod_authn_dbm provides for HTTP Basic - Authentication, where the usernames and passwords are stored in DBM - type database files. Use this option to enable the module.
- -
--enable-authz-dbm
-
mod_authz_dbm provides for HTTP Basic - Authorization, where the usernames and groups are stored in DBM - type database files. Use this option to enable the module.
- -
--enable-auth-digest
-
Enable RFC2617 Digest authentication provided by - mod_auth_digest. This module uses plain text files - to store the credentials.
- -
--enable-authnz-ldap
-
Enable LDAP based authentication provided by - mod_authnz_ldap.
- -
--enable-cache
-
Enable dynamic file caching provided by - mod_cache. This experimental module may be - interesting for servers with high load or caching proxy servers. At - least one storage management module (e.g. - mod_disk_cache) is also necessary.
- -
--enable-cern-meta
-
Enable the CERN-type meta files support provided by - mod_cern_meta.
- -
--enable-charset-lite
-
Enable character set translation provided by - mod_charset_lite. This module will be installed by - default only on EBCDIC systems. On other systems, you have to enable - it.
- -
--enable-dav
-
Enable the WebDAV protocol handling provided by - mod_dav. Support for filesystem resources is - provided by the separate module mod_dav_fs. This - module is also automatically enabled with - --enable-dav.
- Note: mod_dav can only be used together with the - http protocol module.
- -
--enable-dav-fs
-
Enable DAV support for filesystem resources, which is provided by - mod_dav_fs. This module is a provider for the - mod_dav module, so you should also use - --enable-dav.
- -
--enable-dav-lock
-
Enable mod_dav_lock which provides generic DAV - locking support for backend modules. This module needs at least - mod_dav to function, so you should also use - --enable-dav.
- -
--enable-deflate
-
Enable deflate transfer encoding provided by - mod_deflate.
- -
--enable-disk-cache
-
Enable disk caching provided by - mod_disk_cache.
- -
--enable-expires
-
Enable Expires header control provided by - mod_expires.
- -
--enable-ext-filter
-
Enable the external filter support provided by - mod_ext_filter.
- -
--enable-file-cache
-
Enable the file cache provided by - mod_file_cache.
- -
--enable-headers
-
Enable control of HTTP headers provided by - mod_headers.
- -
--enable-info
-
Enable the server information provided by - mod_info.
- -
--enable-ldap
-
Enable LDAP caching and connection pooling services provided by - mod_ldap.
- -
--enable-logio
-
Enable logging of input and output bytes including headers provided - by mod_logio.
- -
--enable-mime-magic
-
Enable - automatical determining of MIME - types, which is provided by - mod_mime_magic.
- -
--enable-isapi
-
Enable the isapi extension support provided by - mod_isapi.
- -
--enable-proxy
-
Enable the proxy/gateway functionality provided by - mod_proxy. The proxying capabilities for - AJP13, CONNECT, FTP, - HTTP and the balancer are provided by the separate - modules mod_proxy_ajp, - mod_proxy_connect, mod_proxy_ftp, - mod_proxy_http and - mod_proxy_balancer. - These five modules are also automatically enabled with - --enable-proxy.
- -
--enable-proxy-ajp
-
Enable proxy support for AJP13 (Apache JServ Protocol 1.3) - request handling, which is provided by mod_proxy_ajp. - This module is an extension for the mod_proxy module, - so you should also use --enable-proxy.
- -
--enable-proxy-balancer
-
Enable load balancing support for the AJP13, - FTP and HTTP protocols, which is provided by - mod_proxy_balancer. This module is an extension for the - mod_proxy module, so you should also use - --enable-proxy.
- -
--enable-proxy-connect
-
Enable proxy support for CONNECT request handling, - which is provided by mod_proxy_connect. This module - is an extension for the mod_proxy module, so you - should also use --enable-proxy.
- -
--enable-proxy-ftp
-
Enable proxy support for FTP requests, which is - provided by mod_proxy_ftp. This module - is an extension for the mod_proxy module, so you - should also use --enable-proxy.
- -
--enable-proxy-http
-
Enable proxy support for HTTP requests, which is - provided by mod_proxy_http. This module - is an extension for the mod_proxy module, so you - should also use --enable-proxy.
- -
--enable-rewrite
-
Enable rule based URL manipulation provided by - mod_rewrite.
- -
--enable-so
-
Enable DSO capability provided by mod_so. This - module will be automatically enabled unless you build - all modules statically.
- -
--enable-speling
-
Enable the functionality to correct common URL misspellings, which - is provided by mod_speling.
- -
--enable-ssl
-
Enable support for SSL/TLS provided by - mod_ssl.
- -
--enable-unique-id
-
Enable the generation of per-request unique ids, which is provided - by mod_unique_id.
- -
--enable-usertrack
-
Enable user-session tracking provided by - mod_usertrack.
- -
--enable-vhost-alias
-
Enable mass virtual hosting provided by - mod_vhost_alias.
-
-
- -
Modules for developers -

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.

- -
- -
--enable-bucketeer
-
Enable the manipulation filter for buckets, which is provided by - mod_bucketeer.
- - -
--enable-case-filter
-
Enable the example uppercase conversion output filter support of - mod_case_filter.
- - -
--enable-case-filter-in
-
Enable the example uppercase conversion input filter support of - mod_case_filter_in.
- -
--enable-echo
-
Enable the ECHO server provided by - mod_echo.
- -
--enable-example
-
Enable the example and demo module - mod_example.
- - -
--enable-optional-fn-export
-
Enable the example for an optional function exporter, which is - provided by mod_optional_fn_export.
- - -
--enable-optional-fn-import
-
Enable the example for an optional function importer, which is - provided by mod_optional_fn_import.
- - -
--enable-optional-hook-export
-
Enable the example for an optional hook exporter, which is provided - by mod_optional_hook_export.
- - -
--enable-optional-hook-import
-
Enable the example optional hook importer, which is provided by - mod_optional_hook_import.
-
+ all to be available.

+ +

To find out which modules are compiled by default, run + ./configure -h or ./configure --help + and look under Optional Features. Suppose you + are interested in mod_example1 and + mod_example2, and you + see this:

+ + 
Optional Features:
+  ...
+  --disable-example1     example module 1
+  --enable-example2      example module 2
+  ...
 + +

Then mod_example1 is enabled by default, + and you would use --disable-example1 to not + compile it. mod_example2 is disabled by + default, and you would use --enable-example2 + to compile it.

Multi-Processing Modules