Apache is a modular server. This implies that only the most
basic functionality is included in the core server. Extended
@@ -128,4 +127,4 @@ HTTP server.
\ No newline at end of file
diff --git a/docs/manual/env.html.en b/docs/manual/env.html.en
index 73fd74493b2..cfdec81e8a0 100644
--- a/docs/manual/env.html.en
+++ b/docs/manual/env.html.en
@@ -1,8 +1,8 @@
-Environment Variables in Apache- Apache HTTP Server
Apache HTTP Server Version 2.0
Environment Variables in Apache
+Environment Variables in Apache - Apache HTTP Server
Apache HTTP Server Version 2.0
Environment Variables in Apache
The Apache HTTP Server provides a mechanism for storing
information in named variables that are called environment
variables. This information can be used to control various
@@ -24,7 +24,7 @@
shell.
\ No newline at end of file
diff --git a/docs/manual/filter.html.en b/docs/manual/filter.html.en
index 75689e4963e..b8ff31a53ec 100644
--- a/docs/manual/filter.html.en
+++ b/docs/manual/filter.html.en
@@ -1,12 +1,12 @@
-Filters- Apache HTTP Server
Apache HTTP Server Version 2.0
Filters
+Filters - Apache HTTP Server
Apache HTTP Server Version 2.0
Filters
This document describes the use of filters in Apache.
A filter is a process that is applied to data that
is sent or received by the server. Data sent by clients to the
@@ -33,4 +33,4 @@
In addition, the module mod_ext_filter allows
for external programs to be defined as filters.
-
Apache HTTP Server Version 2.0
\ No newline at end of file
+
Apache HTTP Server Version 2.0
\ No newline at end of file
diff --git a/docs/manual/handler.html.en b/docs/manual/handler.html.en
index 48648277e09..a17d135beb2 100644
--- a/docs/manual/handler.html.en
+++ b/docs/manual/handler.html.en
@@ -1,12 +1,12 @@
-Apache's Handler Use- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache's Handler Use
+Apache's Handler Use - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache's Handler Use
This document describes the use of Apache's Handlers.
A "handler" is an internal Apache representation of the
@@ -108,4 +108,4 @@
type. While it is not necessary, the naming convention for
handlers is to use a dash-separated word, with no slashes, so
as to not invade the media type name-space.
-
Apache HTTP Server Version 2.0
\ No newline at end of file
+
Apache HTTP Server Version 2.0
\ No newline at end of file
diff --git a/docs/manual/logs.html.en b/docs/manual/logs.html.en
index 9925b9ef964..a0f71fcc1cc 100644
--- a/docs/manual/logs.html.en
+++ b/docs/manual/logs.html.en
@@ -1,8 +1,8 @@
-Log Files- Apache HTTP Server
Apache HTTP Server Version 2.0
Log Files
+Log Files - Apache HTTP Server
Apache HTTP Server Version 2.0
Log Files
In order to effectively manage a web server, it is necessary
to get feedback about the activity and performance of the
server as well as any problems that may be occuring. The Apache
@@ -93,7 +93,7 @@
\ No newline at end of file
diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en
index b977250b8fc..55f10be5021 100644
--- a/docs/manual/mod/core.html.en
+++ b/docs/manual/mod/core.html.en
@@ -1,9 +1,18 @@
-core- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module core
Description:
Core Apache HTTP Server features that are always
-available
When returning a document to the client the server looks for
the first existing configuration file from this list of names in
every directory of the path to the document, if distributed
@@ -76,8 +91,15 @@ AccessFileName .acl
AllowOverride None
</Directory>
This directive specifies the name of the character set that
will be added to any response that does not have any parameter on
@@ -93,9 +115,15 @@ response without an explicit character set
When the server finds an .htaccess file (as specified by AccessFileName) it needs to know
which directives declared in that file can override earlier
access information.
@@ -157,8 +185,14 @@ response without an explicit character set
This directive sets the name of the authorization realm for a
directory. This realm is given to the client so that the user
knows which username and password to send.
@@ -176,7 +210,13 @@ authentication
This directive selects the type of user authentication for a
directory. Only Basic and Digest are
currently implemented.
@@ -186,13 +226,28 @@ authentication
This directive is used to control how Apache finds the
interpreter used to run CGI scripts. For example, setting CGIMapExtension sys:\foo.nlm .foo will
cause all CGI script files with a .foo extension to be passed to the FOO interpreter.
<Directory> and
</Directory> are used to enclose a group of
directives that will apply only to the named directory and
@@ -345,10 +412,15 @@ such as via different symbolic links.
<DirectoryMatch> and
</DirectoryMatch> are used to enclose a group
of directives which will apply only to the named directory and
@@ -364,8 +436,14 @@ subdirectories
This directive sets the directory from which httpd will
serve files. Unless matched by a directive like Alias, the
server appends the path from the requested URL to the document
@@ -380,7 +458,14 @@ from the web
This directive controls whether the httpd may use
memory-mapping if it needs to read the contents of a file during
delivery. By default, when the handling of a request requires
@@ -407,8 +492,15 @@ Location
The ErrorLog directive sets the name of
the file to which the server will log any errors it encounters. If
the file-path does not begin with a slash (/) then it is
@@ -491,8 +589,14 @@ ErrorLog logs/error.log (Windows and OS/2)
The <FilesMatch> directive
provides for access control by filename, just as the <Files> directive
does. However, it accepts a regular expression. For example:
This directive enables DNS lookups so that host names can be
logged (and passed to CGIs/SSIs in REMOTE_HOST).
The value double refers to doing double-reverse
@@ -627,8 +756,14 @@ MIME content-type
logresolve, provided in
the /support directory, can be used to look up host
names from logged IP addresses offline.
-
This directive enables RFC1413-compliant logging of the
remote user name for each connection, where the client machine
runs identd or something similar. This information is logged in
@@ -643,9 +778,15 @@ user
The <IfDefine
test>...</IfDefine> section is used to
mark directives that are conditional. The directives within an
@@ -686,9 +827,15 @@ if a test is true at startup
The <IfModule
test>...</IfModule> section is used to
mark directives that are conditional. The directives within an
@@ -719,8 +866,13 @@ presence of absence of a specific module
The Keep-Alive extension to HTTP/1.0 and the persistent
connection feature of HTTP/1.1 provide long-lived HTTP sessions
which allow multiple requests to be sent over the same TCP
@@ -785,8 +943,14 @@ the server configuration files
The number of seconds Apache will wait for a subsequent
request before closing the connection. Once a request has been
received, the timeout value specified by the
@@ -796,9 +960,15 @@ requests on a persistent connection
Access controls are normally effective for
all access methods, and this is the usual
desired behavior. In the general case, access control
@@ -823,9 +993,15 @@ methods
<LimitExcept> and
</LimitExcept> are used to enclose
a group of access control directives which will then apply to any
@@ -842,8 +1018,15 @@ except the named ones
This directive specifies the number of bytes from 0
(meaning unlimited) to 2147483647 (2GB) that are allowed in a
request body. The default value is defined by the compile-time
@@ -876,8 +1059,14 @@ from the client
Number is an integer from 0 (meaning unlimited) to
32767. The default value is defined by the compile-time
constant DEFAULT_LIMIT_REQUEST_FIELDS (100 as
@@ -907,8 +1096,14 @@ will be accepted from the client
This directive specifies the number of bytes from 0
to the value of the compile-time constant
DEFAULT_LIMIT_REQUEST_FIELDSIZE (8190 as
@@ -938,8 +1133,14 @@ client
Under normal conditions, the value should not be changed from
the default.
This directive sets the number of bytes from 0 to
the value of the compile-time constant
DEFAULT_LIMIT_REQUEST_LINE (8190 as distributed)
@@ -968,7 +1169,13 @@ from the client
The <Location> directive
provides for access control by URL. It is similar to the
<Directory>
@@ -1050,9 +1262,14 @@ request is to /abc//def then it will match.
The <LocationMatch> directive
provides for access control by URL, in an identical manner to
<Location>. However, it takes a regular
@@ -1067,7 +1284,13 @@ matching URLs
LogLevel adjusts the verbosity of the
messages recorded in the error logs (see ErrorLog directive). The following
levels are available, in order of decreasing
@@ -1163,8 +1386,14 @@ matching URLs
The MaxKeepAliveRequests directive
limits the number of requests allowed per connection when
KeepAlive is on. If it is
@@ -1175,8 +1404,13 @@ connection
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
@@ -1406,8 +1659,14 @@ by Apache children
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
@@ -1425,8 +1684,14 @@ by Apache children
Takes 1 or 2 parameters. The first parameter sets the soft
resource limit for all processes and the second parameter sets
the maximum resource limit. Either parameter can be a number,
@@ -1450,8 +1715,15 @@ processes launched by Apache children
Access policy if both Allow and Require used. The parameter can be
either 'all' or 'any'. This directive is only
useful if access to a particular area is being restricted by both
@@ -1475,16 +1747,29 @@ user authentication
This directive is used to control how Apache finds the
interpreter used to run CGI scripts. The default technique is to
use the interpreter pointed to by the #! line in the
script. Setting ScriptInterpreterSource registry will
cause the Windows Registry to be searched using the script file
extension (e.g., .pl) as a search key.
The ServerRoot directive sets the
directory in which the server lives. Typically it will contain the
subdirectories conf/ and logs/. Relative
@@ -1559,7 +1866,14 @@ is accessed by an incompatible browser
The ServerSignature directive allows the
configuration of a trailing footer line under server-generated
documents (error messages, mod_proxy ftp directory listings,
@@ -1574,7 +1888,13 @@ is accessed by an incompatible browser
This directive controls whether Server response
header field which is sent back to clients includes a
description of the generic OS-type of the server as well as
@@ -1604,8 +1924,15 @@ is accessed by an incompatible browser
The SetInputFilter directive sets the
filter or filters which will process client requests and POST
input when they are received by the server. This is in addition to
@@ -1641,8 +1974,14 @@ input
The SetOutputFilter directive sets the filters
which will process responses from the server before they are
sent to the client. This is in addition to any filters defined
@@ -1662,8 +2001,14 @@ server
In many situations Apache must construct a
self-referential URL -- that is, a URL that refers back to
the same server. With UseCanonicalName on Apache will
@@ -1730,10 +2081,15 @@ port
<VirtualHost> and
</VirtualHost> are used to enclose a group of
directives that will apply only to a particular virtual host. Any
diff --git a/docs/manual/mod/index.html.en b/docs/manual/mod/index.html.en
index b09350c430c..9ddb0c867c5 100644
--- a/docs/manual/mod/index.html.en
+++ b/docs/manual/mod/index.html.en
@@ -1,4 +1,8 @@
-
Module Index- Apache HTTP Server
Apache HTTP Server Version 2.0
Module Index
+Module Index - Apache HTTP Server
Apache HTTP Server Version 2.0
Module Index
Below is a list of all of the modules that come as part of
the Apache distribution. See also the complete
diff --git a/docs/manual/mod/mod_actions.html.en b/docs/manual/mod/mod_actions.html.en
index aa902e6c460..86c404f5079 100644
--- a/docs/manual/mod/mod_actions.html.en
+++ b/docs/manual/mod/mod_actions.html.en
@@ -1,21 +1,30 @@
-
mod_actions- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_actions
Description:
This module provides for executing CGI scripts based on
-media type or request method.
This module has two directives. The Action directive lets you run CGI
scripts whenever a file of a certain type is requested. The
Script directive lets
you run CGI scripts whenever a particular method is used in a
request. This makes it much easier to execute scripts that process
files.
This directive adds an action, which will activate
cgi-script when action-type is triggered by the
request. The cgi-script is the URL-path to a resource
- that has been designated as a CGI script using ScriptAliase or AddHandler. The
+ that has been designated as a CGI script using ScriptAliase or AddHandler. The
action-type can be either a handler or a MIME content type. It
sends the URL and file path of the requested document using the
standard CGI PATH_INFO and PATH_TRANSLATED environment
@@ -39,12 +48,17 @@ content-type
This directive adds an action, which will activate
cgi-script when a file is requested using the method of
method. The cgi-script is the URL-path to a
- resource that has been designated as a CGI script using ScriptAliase or AddHandler. The URL and
+ resource that has been designated as a CGI script using ScriptAliase or AddHandler. The URL and
file path of the requested document is sent using the standard CGI
PATH_INFO and PATH_TRANSLATED environment variables.
diff --git a/docs/manual/mod/mod_alias.html.en b/docs/manual/mod/mod_alias.html.en
index 9ad7cd864ec..926ac407cbc 100644
--- a/docs/manual/mod/mod_alias.html.en
+++ b/docs/manual/mod/mod_alias.html.en
@@ -1,14 +1,17 @@
-mod_alias- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_alias
Description:
Provides for mapping different parts of the host
- filesystem in the document tree and for URL redirection
The directives contained in this module allow for manipulation
and control of URLs as requests arrive at the server. The
Alias and ScriptAlias directives are used to
map between URLs and filesystem paths. This allows for content
- which is not directly under the DocumentRoot served as part of the web
+ which is not directly under the DocumentRoot served as part of the web
document tree. The ScriptAlias directive has the
additional effect of marking the target directory as containing
only CGI scripts.
@@ -17,12 +20,17 @@
directives are used to instruct clients to make a new request with
a different URL. They are often used when a resource has moved to
a new location.
-
The Alias directive allows documents to
be stored in the local filesystem other than under the
- DocumentRoot. URLs with a
+ DocumentRoot. URLs with a
(%-decoded) path beginning with url-path will be mapped
to local files beginning with directory-filename.
@@ -39,17 +47,22 @@
/icons/ /usr/local/apache/icons/ then the url
/icons will not be aliased.
-
Note that you may need to specify additional <Directory> sections which cover
+
Note that you may need to specify additional <Directory> sections which cover
the destination of aliases. Aliasing occurs before
- <Directory> sections
+ <Directory> sections
are checked, so only the destination of aliases are affected.
- (Note however <Location>
+ (Note however <Location>
sections are run through once before aliases are performed, so
they will apply.)
This directive is equivalent to Alias, but makes use of standard
regular expressions, instead of simple prefix matching. The
supplied regular expression is matched against the URL-path, and
@@ -60,8 +73,14 @@ expressions
The Redirect directive maps an old URL into a new one. The
new URL is returned to the client which attempts to fetch it
again with the new address. URL-path a (%-decoded)
@@ -81,7 +100,7 @@ a different URL
This directive is equivalent to Redirect, but makes use of standard
regular expressions, instead of simple prefix matching. The
supplied regular expression is matched against the URL-path, and
@@ -139,23 +164,40 @@ current URL
The ScriptAlias directive has the same
behavior as the Alias
directive, except that in addition it marks the target directory
- as containing CGI scripts that will be processed by mod_cgi's cgi-script handler. URLs with a
+ as containing CGI scripts that will be processed by mod_cgi's cgi-script handler. URLs with a
(%-decoded) path beginning with URL-path will be mapped
to scripts beginning with the second argument which is a full
pathname in the local filesystem.
This directive is equivalent to ScriptAlias, but makes use of standard
regular expressions, instead of simple prefix matching. The
supplied regular expression is matched against the URL-path,
diff --git a/docs/manual/mod/mod_asis.html.en b/docs/manual/mod/mod_asis.html.en
index 794891aaf5f..937af855035 100644
--- a/docs/manual/mod/mod_asis.html.en
+++ b/docs/manual/mod/mod_asis.html.en
@@ -1,9 +1,12 @@
-
This module allows the use of HTTP Basic Authentication to
restrict access by looking up users in plain text password and
group files. Similar functionality and greater scalability is
- provided by mod_auth_dbm. HTTP Digest
+ provided by mod_auth_dbm. HTTP Digest
Authentication is provided by
- mod_auth_digest.
This information has not been updated for Apache 2.0, which
uses a different system for module ordering.
@@ -28,14 +38,14 @@ uses a different system for module ordering.
an Authorization Required reply.
So if a userID appears in the database of more than one module;
- or if a valid Require
+ or if a valid Require
directive applies to more than one module; then the first module
will verify the credentials; and no access is passed on;
regardless of the AuthAuthoritative setting.
A common use for this is in conjunction with one of the
- database modules; such as auth_dbm,
- mod_auth_msql, and mod_auth_anon.
+ database modules; such as auth_dbm,
+ mod_auth_msql, and mod_auth_anon.
These modules supply the bulk of the user credential checking; but
a few (administrator) related accesses fall through to a lower
level with a well protected AuthUserFile.
@@ -54,13 +64,19 @@ uses a different system for module ordering.
directory that it protects. Otherwise, clients will be able to
download the AuthUserFile.
-
The AuthGroupFile directive sets the
name of a textual file containing the list of user groups for user
authentication. File-path is the path to the group
file. If it is not absolute (i.e., if it doesn't begin
- with a slash), it is treated as relative to the ServerRoot.
+ with a slash), it is treated as relative to the ServerRoot.
Each line of the group file contains a groupname followed by a
colon, followed by the member usernames separated by spaces.
@@ -69,7 +85,7 @@ of user groups for authentication
The AuthUserFile directive sets the name
of a textual file containing the list of users and passwords for
user authentication. File-path is the path to the user
file. If it is not absolute (i.e., if it doesn't begin
- with a slash), it is treated as relative to the ServerRoot.
+ with a slash), it is treated as relative to the ServerRoot.
Each line of the user file file contains a username followed by
a colon, followed by the crypt() encrypted
@@ -105,7 +127,7 @@ passwords for authentication
Note that searching large text files is very
- inefficient; AuthDBMUserFile should be used
+ inefficient; AuthDBMUserFile should be used
instead.
Security
Make sure that the AuthUserFile is
diff --git a/docs/manual/mod/mod_auth_anon.html.en b/docs/manual/mod/mod_auth_anon.html.en
index 084f62d5c18..7cb291f3681 100644
--- a/docs/manual/mod/mod_auth_anon.html.en
+++ b/docs/manual/mod/mod_auth_anon.html.en
@@ -1,9 +1,12 @@
-
mod_auth_anon- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_auth_anon
Description:
Allows "anonymous" user access to authenticated
- areas
This module does access control in a manner similar to
anonymous-ftp sites; i.e. have a 'magic' user id
'anonymous' and the email address as a password. These email
@@ -68,8 +71,14 @@
Require valid-user
</Files>
A list of one or more 'magic' userIDs which are allowed
access without password verification. The userIDs are space
separated. It is possible to use the ' and " quotes to allow a
@@ -87,8 +96,15 @@ password verification
When set 'on', there is no fall-through to other authorization
methods. So if a userID does not match the values specified in the
Anonymous directive,
@@ -98,21 +114,49 @@ to other methods
When set on, users can leave the userID (and
perhaps the password field) empty. This can be very convenient for
MS-Explorer users who can just hit return or click directly on the
OK button; which seems a natural reaction.
When set on the 'password' entered is checked for
at least one '@' and a '.' to encourage users to enter valid email
addresses (see the above Auth_LogEmail).
diff --git a/docs/manual/mod/mod_auth_dbm.html.en b/docs/manual/mod/mod_auth_dbm.html.en
index 75b47d67546..d087557b48a 100644
--- a/docs/manual/mod/mod_auth_dbm.html.en
+++ b/docs/manual/mod/mod_auth_dbm.html.en
@@ -1,15 +1,25 @@
-mod_auth_dbm- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_auth_dbm
Description:
Provides for user authentication using DBM
- files
This module provides for HTTP Basic Authentication, where
the usernames and passwords are stored in DBM type database
files. It is an alternative to the plain text password files
- provided by mod_auth.
This information has not been updated to take into account the
new module ordering techniques in Apache 2.0
@@ -25,13 +35,13 @@ new module ordering techniques in Apache 2.0
Required reply.
So if a userID appears in the database of more than one module;
- or if a valid Require
+ or if a valid Require
directive applies to more than one module; then the first module
will verify the credentials; and no access is passed on;
regardless of the AuthAuthoritative setting.
A common use for this is in conjunction with one of the
- basic auth modules; such as mod_auth. Whereas this
+ basic auth modules; such as mod_auth. Whereas this
DBM module supplies the bulk of the user credential checking; a
few (administrator) related accesses fall through to a lower
level with a well protected .htpasswd file.
@@ -46,8 +56,14 @@ new module ordering techniques in Apache 2.0
is really what you want; Generally it is easier to just secure
a single .htpasswd file, than it is to secure a database which
might have more access interfaces.
-
The AuthDBMGroupFile directive sets the
name of a DBM file containing the list of user groups for user
authentication. File-path is the absolute path to the
@@ -90,8 +106,16 @@ AuthDBMUserFile /www/userbase
DBM file after another colon; it is ignored by the authentication
module. This is what www.telescope.org uses for its combined
password and group database.
Sets the type of database file that is used to store the passwords.
The default database type is determined at compile time. The
@@ -100,8 +124,14 @@ compile-time settings.
It is crucial that whatever program you use to create your password
files is configured to use the same type of database.
The AuthDBMUserFile directive sets the
name of a DBM file containing the list of users and passwords for
user authentication. File-path is the absolute path to
diff --git a/docs/manual/mod/mod_auth_digest.html.en b/docs/manual/mod/mod_auth_digest.html.en
index 331d8497a79..4ceb02dd4b0 100644
--- a/docs/manual/mod/mod_auth_digest.html.en
+++ b/docs/manual/mod/mod_auth_digest.html.en
@@ -1,13 +1,16 @@
-
mod_auth_digest- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_auth_digest
Description:
User authentication using MD5
- Digest Authentication.
Using MD5 Digest authentication is very simple. Simply set
up authentication normally, using "AuthType Digest" and
@@ -37,8 +40,15 @@
authentication, you should use it only in controlled settings.
The AuthDigestDomain directive allows
you to specify one or more URIs which are in the same protection
space (i.e. use the same realm and username/password info). The
@@ -68,8 +84,14 @@ authentication
The AuthDigestFile directive sets the
name of a textual file containing the list of users and encoded
passwords for digest authentication. File-path is the
@@ -78,8 +100,14 @@ of users and encoded passwords for digest authentication
The digest file uses a special format. Files in this format
can be created using the htdigest utility found in
the support/ subdirectory of the Apache distribution.
-
The AuthDigestGroupFile directive sets
the name of a textual file containing the list of groups and their
members (user names). File-path is the absolute path to
@@ -98,14 +126,34 @@ for digest authentication
The AuthDigestNonceLifetime directive
controls how long the server nonce is valid. When the client
contacts the server using an expired nonce the server will send
@@ -115,8 +163,15 @@ server
The AuthDigestQop directive determines
the quality-of-protection to use. auth will only do
authentication (username/password); auth-int is
diff --git a/docs/manual/mod/mod_autoindex.html.en b/docs/manual/mod/mod_autoindex.html.en
index 323698cdbb9..f438f344746 100644
--- a/docs/manual/mod/mod_autoindex.html.en
+++ b/docs/manual/mod/mod_autoindex.html.en
@@ -1,18 +1,21 @@
-
mod_autoindex- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_autoindex
Description:
Generates directory indexes,
+mod_autoindex - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_autoindex
Description:
+
Generates directory indexes,
automatically, similar to the Unix ls command or the
- Win32 dir shell command
The index of a directory can come from one of two
sources:
A file written by the user, typically called
- index.html. The DirectoryIndex directive sets the
+ index.html. The DirectoryIndex directive sets the
name of this file. This is controlled by
- mod_dir.
Otherwise, a listing generated by the server. The other
directives control the format of this listing. The AddIcon, AddIconByEncoding and
@@ -20,7 +23,7 @@
used to set a list of icons to display for various file types;
for each file listed, the first icon listed that matches the
file is displayed. These are controlled by
- mod_autoindex.
If the FancyIndexing
+ option is given with the IndexOptions directive,
the column headers are links that control the order of the
display. If you select a header link, the listing will be
regenerated, sorted by the values in that column. Selecting the
same header repeatedly toggles between ascending and descending
order. These column header links are suppressed with
- IndexOptions directive's
+ IndexOptions directive's
SuppressColumnSorting option.
Note that when the display is sorted by "Size", it's the
@@ -138,8 +141,14 @@
</FORM>
AddAlt provides the alternate text to
display for a file, instead of an icon, for FancyIndexing.
File is a file extension, partial filename, wild-card
@@ -153,9 +162,15 @@ icon selected by filename
AddAltByEncoding provides the alternate
text to display for a file, instead of an icon, for FancyIndexing.
MIME-encoding is a valid content-encoding, such as
@@ -168,9 +183,15 @@ selected by MIME-encoding
AddAltByType sets the alternate text to
display for a file, instead of an icon, for FancyIndexing.
MIME-type is a valid content-type, such as
@@ -183,8 +204,14 @@ icon selected by MIME content-type
This sets the description to display for a file, for
FancyIndexing.
File is a file extension, partial filename, wild-card
@@ -216,8 +243,14 @@ icon selected by MIME content-type
This sets the icon to display next to a file ending in
name for FancyIndexing.
Icon is either a (%-escaped) relative URL to the icon,
@@ -239,9 +272,15 @@ icon selected by MIME content-type
AddIconByType
should be used in preference to AddIcon,
when possible.
-
This sets the icon to display next to files with FancyIndexing.
Icon is either a (%-escaped) relative URL to the icon,
or of the format (alttext,url) where
@@ -252,9 +291,15 @@ content-encoding
This sets the icon to display next to files of type
MIME-type for FancyIndexing.
Icon is either a (%-escaped) relative URL to the icon,
@@ -266,15 +311,27 @@ content-type
The DefaultIcon directive sets the icon
to display for files when no specific icon is known, for FancyIndexing.
Url-path is a (%-escaped) relative URL to the icon.
Examples:
Content negotiation
- will be performed if the MultiViewsOption is enabled. If
+ will be performed if the MultiViewsOption is enabled. If
filename resolves to a static text/html
document (not a CGI script) and the Includes
- option is enabled, the file
+ option is enabled, the file
will be processed for server-side includes (see the
- mod_include documentation).
If the file specified by HeaderName contains
@@ -310,8 +367,14 @@ HeaderName HEADER.html
etc) then you will probably want to set IndexOptions
+SuppressHTMLPreamble, so that these tags are not
repeated.
The IndexIgnore directive adds to the
list of files to hide when listing a directory. File is a
file extension, partial filename, wildcard expression or full
@@ -321,8 +384,14 @@ a directory
The IndexOrderDefault directive is used
in combination with the FancyIndexing
index option. By default, fancyindexed directory listings are
@@ -626,8 +701,14 @@ Ascending|Descending Name|Date|Size|Description
SuppressColumnSorting
index option; this will prevent the client from requesting the
directory listing in a different order.
-
The ReadmeName directive sets the name
of the file that will be appended to the end of the index
listing. Filename is the name of the file to include, and
diff --git a/docs/manual/mod/mod_cache.html.en b/docs/manual/mod/mod_cache.html.en
index 72354bcc4b3..72de808071c 100644
--- a/docs/manual/mod/mod_cache.html.en
+++ b/docs/manual/mod/mod_cache.html.en
@@ -1,8 +1,11 @@
-
The CacheEnable directive instructs
mod_cache to cache urls at or below url-string.
The cache store is specified with the cache_type argument.
@@ -83,30 +101,55 @@ LoadModule cache_module modules/mod_cache.so
CacheEnable mem /manual
CacheEnable fd /images
Emulate the CERN HTTPD Meta file semantics. Meta files are HTTP
headers that can be output in addition to the normal range of
headers for each file accessed. They appear rather like the
@@ -14,8 +17,14 @@
Specifies the name of the directory in which Apache can find
meta information files. The directory is usually a 'hidden'
subdirectory of the directory that contains the file being
@@ -28,10 +37,22 @@ files
Specifies the file name suffix for the file containing the
meta information. For example, the default values for the two
directives will cause a request to
diff --git a/docs/manual/mod/mod_cgi.html.en b/docs/manual/mod/mod_cgi.html.en
index 5bd6341717c..9f3d10ec0b8 100644
--- a/docs/manual/mod/mod_cgi.html.en
+++ b/docs/manual/mod/mod_cgi.html.en
@@ -1,8 +1,11 @@
-
@@ -13,14 +16,14 @@
as a CGI script, and run by the server, with its output being
returned to the client. Files acquire this type either by
having a name containing an extension defined by the
- AddType directive, or by being
- in a ScriptAlias
+ AddType directive, or by being
+ in a ScriptAlias
directory.
When the server invokes a CGI script, it will add a variable
called DOCUMENT_ROOT to the environment. This
variable will contain the value of the
- DocumentRoot configuration
+ DocumentRoot configuration
variable.
For an introduction to using CGI scripts with Apache, see
@@ -28,10 +31,10 @@
With CGI.
When using a multi-threaded MPM under unix, the module
- mod_cgid should be used in place of
+ mod_cgid should be used in place of
this module. At the user level, the two modules are essentially
identical.
The server will set the CGI environment variables as described
in the CGI
specification, with the following provisions:
@@ -39,7 +42,7 @@
PATH_INFO
-
This will not be available if the AcceptPathInfo directive is explicitly set to
+
This will not be available if the AcceptPathInfo directive is explicitly set to
off. The default behavior, if AcceptPathInfo is
not given, is that mod_cgi will accept path info (trailing
/more/path/info following the script filename in the URI), while
@@ -50,13 +53,13 @@
This will only be set if HostnameLookups is set to on (it
is off by default), and if a reverse DNS lookup of the accessing
host's address indeed finds a host name.
This will only be set if IdentityCheck is set to
on and the accessing host supports the ident
protocol. Note that the contents of this variable cannot be
relied upon because it can easily be faked, and if there is a
@@ -107,7 +110,12 @@
(The %stdout and %stderr parts may be missing if the script did
not output anything on standard output or standard error).
The ScriptLog directive sets the CGI
script error logfile. If no ScriptLog is given, no error log is
created. If given, any CGI errors are logged into the filename
@@ -119,7 +127,7 @@
This log will be opened as the user the child processes run
- as, ie. the user specified in the main User directive. This means that
+ as, ie. the user specified in the main User directive. This means that
either the directory the script log is in needs to be writable
by that user or the file needs to be manually created and set
to be writable by that user. If you place the script log in
@@ -132,14 +140,26 @@
continuously on running servers. It is not optimized for speed
or efficiency, and may have security problems if used in a
manner other than that for which it was designed.
The size of any PUT or POST entity body that is logged to
the file is limited, to prevent the log file growing too big
too quickly if large bodies are being received. By default, up
to 1024 bytes are logged, but this can be changed with this
directive.
ScriptLogLength can be used to limit the
size of the CGI script logfile. Since the logfile logs a lot of
information per CGI error (all request headers, all script output)
diff --git a/docs/manual/mod/mod_cgid.html.en b/docs/manual/mod/mod_cgid.html.en
index 28f08fa87ea..6302e89f190 100644
--- a/docs/manual/mod/mod_cgid.html.en
+++ b/docs/manual/mod/mod_cgid.html.en
@@ -1,12 +1,16 @@
-
mod_cgid- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_cgid
Description:
Execution of CGI scripts using an
- external CGI daemon
Except for the optimizations and the additional ScriptSock directive noted below,
mod_cgid behaves similarly to mod_cgi. See the
- mod_cgi Summary for additional details about
+ mod_cgi Summary for additional details about
Apache and CGI.
On certain unix operating systems, forking a process from a
@@ -19,14 +23,20 @@
socket.
This module is used by default instead of
- mod_cgi whenever a multi-threaded MPM
+ mod_cgi whenever a multi-threaded MPM
is selected during the compilation process. At the user level,
this module is identical in configuration and operation to
- mod_cgi. The only exception is the
+ mod_cgi. The only exception is the
additional directive ScriptSock which gives the
name of the socket to use for communication with the cgi
daemon.
This directive sets the name of the socket to use for
communication with the CGI daemon. The socket will be opened
using the permissions of the user who starts Apache (usually
diff --git a/docs/manual/mod/mod_charset_lite.html.en b/docs/manual/mod/mod_charset_lite.html.en
index 6d304588a06..0b3b0715c94 100644
--- a/docs/manual/mod/mod_charset_lite.html.en
+++ b/docs/manual/mod/mod_charset_lite.html.en
@@ -1,25 +1,28 @@
-
This is an experimental module and should
be used with care. Experiment with your
mod_charset_lite configuration to ensure that it
performs the desired function.
mod_charset_lite allows the administrator to
specify the source character set of objects as well as the
character set they should be translated into before sending to the
- client. mod_charset_lite does not translate the
+ client. mod_charset_lite does not translate the
data itself but instead tells Apache what translation to
- perform. mod_charset_lite is applicable to EBCDIC
+ perform. mod_charset_lite is applicable to EBCDIC
and ASCII host environments. In an EBCDIC environment, Apache
normally translates text content from the code page of the Apache
- process locale to ISO-8859-1. mod_charset_lite
+ process locale to ISO-8859-1. mod_charset_lite
can be used to specify that a different translation is to be
performed. In an ASCII environment, Apache normally performs no
- translation, so mod_charset_lite is needed in
+ translation, so mod_charset_lite is needed in
order for any translation to take place.
This module provides a small subset of configuration
@@ -32,7 +35,7 @@
The character set name parameters of CharsetSourceEnc and
CharsetDefault
must be acceptable to the translation mechanism used by APR on the
- system where mod_charset_lite is deployed. These
+ system where mod_charset_lite is deployed. These
character set names are not standardized and are usually not the
same as the corresponding values used in http headers. Currently,
APR can only use iconv(3), so you can easily test your character
@@ -57,7 +60,13 @@
it cannot translate the input buffer.
-
The CharsetOptions directive configures certain
- behaviors of mod_charset_lite. Option can
+ behaviors of mod_charset_lite. Option can
be one of
@@ -84,7 +100,7 @@ NoImplicitAdd
mod_charset_lite. By default, no messages are
+ mod_charset_lite. By default, no messages are
generated. This is equivalent to DebugLevel=0.
With higher numbers, more debug messages are generated, and
server performance will be degraded. The actual meanings of
@@ -95,14 +111,20 @@ NoImplicitAdd
mod_charset_lite should implicitly insert its
+ mod_charset_lite should implicitly insert its
filter when the configuration specifies that the character
set of content should be translated. If the filter chain is
explicitly configured using the AddOutputFilter directive,
NoImplicitAdd should be specified so that
- mod_charset_lite doesn't add its filter.
+ mod_charset_lite doesn't add its filter.
-
This module provides class 1 and class 2 WebDAV ('Web-based Distributed
Authoring and Versioning') functionality for Apache. This
extension to the HTTP protocol allows creating, moving,
@@ -23,11 +26,17 @@
(Any web-server writable filename, without an
extension)
Use the Dav directive to enable the
WebDAV HTTP methods for the given container. You may wish to add a
- <Limit> clause
- inside the <location> directive to limit access to
+ <Limit> clause
+ inside the <location> directive to limit access to
DAV-enabled locations.
Use the DavDepthInfinity directive to
allow the processing of PROPFIND requests containing the header
'Depth: Infinity'. Because this type of request could constitute a
denial-of-service attack, by default it is not allowed.
Use the DavLockDB directive to specify
the full path to the lock database, excluding an extension. The
default (file system) implementation of mod_dav uses a SDBM
@@ -61,8 +81,14 @@
When a client requests a DAV resource lock, it can also
specify a time when the lock will be automatically removed by
the server. This value is only a request, and the server can
diff --git a/docs/manual/mod/mod_dir.html.en b/docs/manual/mod/mod_dir.html.en
index 429c57db937..cc9c98d248e 100644
--- a/docs/manual/mod/mod_dir.html.en
+++ b/docs/manual/mod/mod_dir.html.en
@@ -1,19 +1,22 @@
-
mod_dir- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_dir
Description:
Provides for "trailing slash" redirects and
- serving directory index files
The two functions are separated so that you can completely
remove (or replace) automatic index generation should you want
@@ -23,11 +26,18 @@
receives a request for a URL
http://servername/foo/dirname where
dirname is a directory. Directories require a
- trailing slash, so mod_dir issues a redirect to
+ trailing slash, so mod_dir issues a redirect to
http://servername/foo/dirname/.
The DirectoryIndex directive sets the
list of resources to look for, when the client requests an index
of the directory by specifying a / at the end of the a directory
diff --git a/docs/manual/mod/mod_env.html.en b/docs/manual/mod/mod_env.html.en
index e934008ef4d..bd52ddb3d7d 100644
--- a/docs/manual/mod/mod_env.html.en
+++ b/docs/manual/mod/mod_env.html.en
@@ -1,29 +1,50 @@
-
mod_env- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_env
Description:
Modifies the environment which is
- passed to CGI scripts and SSI pages
This module allows for control of the environment that will
be provided to CGI scripts and SSI pages. Environment variables
may be passed from the shell which invoked the httpd process.
Alternatively, environment variables may be set or unset within
the configuration process.
Specifies one or more environment variables to pass to CGI
scripts and SSI pages from the environment of the shell which
invoked the httpd process. Example:
The Example directive just sets a demonstration
flag which the example module's content handler displays. It
takes no arguments. If you browse to an URL to which the
diff --git a/docs/manual/mod/mod_expires.html.en b/docs/manual/mod/mod_expires.html.en
index 650ea3a6235..3ecc4f12b69 100644
--- a/docs/manual/mod/mod_expires.html.en
+++ b/docs/manual/mod/mod_expires.html.en
@@ -1,10 +1,13 @@
-
mod_expires- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_expires
Description:
Generation of
+mod_expires - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_expires
Description:
+
Generation of
Expires HTTP headers according to user-specified
- criteria
This module controls the setting of the Expires
HTTP header in server responses. The expiration date can set to
be relative to either the time the source file was last
@@ -85,7 +88,13 @@ ExpiresByType text/html "access plus 1 month 15
Expires header will not be added to content
that does not come from a file on disk. This is due to the fact
that there is no modification time for such content.
This directive enables or disables the generation of the
Expires header for the document realm in question.
(That is, if found in an .htaccess file, for
@@ -104,9 +113,15 @@ ExpiresByType text/html "access plus 1 month 15
Expires header will be generated. If the criteria
aren't met, no header will be sent, and the effect will be as
though this directive wasn't even specified.
This directive defines the value of the Expires
header generated for documents of the specified type
(e.g., text/html). The second argument
@@ -150,7 +165,13 @@ ExpiresByType text/html M604800
You can also specify the expiration time calculation using
an alternate syntax, described earlier in
this document.
This directive sets the default algorithm for calculating the
expiration time for all documents in the affected realm. It can be
overridden on a type-by-type basis by the ExpiresByType directive. See the
diff --git a/docs/manual/mod/mod_ext_filter.html.en b/docs/manual/mod/mod_ext_filter.html.en
index 3f6f552d78f..13841d687d0 100644
--- a/docs/manual/mod/mod_ext_filter.html.en
+++ b/docs/manual/mod/mod_ext_filter.html.en
@@ -1,18 +1,21 @@
-
mod_ext_filter- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_ext_filter
Description:
Pass the response body
+mod_ext_filter - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_ext_filter
Description:
+
Pass the response body
through an external program before delivery to the
- client
This is an experimental module and should
- be used with care. Test your mod_ext_filter
+ be used with care. Test your mod_ext_filter
configuration carefully to ensure that it performs the desired
function. You may wish to review
this information for background on the Apache filtering
model.
mod_ext_filter presents a simple and familiar
programming model for filters. With this module, a program
which reads from stdin and writes to stdout (i.e., a Unix-style
filter command) can be a filter for Apache. This filtering
@@ -82,7 +85,7 @@
Note: this gzip example is just for the purposes of illustration.
- Please refer to mod_deflate for a practical
+ Please refer to mod_deflate for a practical
implementation.
\ No newline at end of file
diff --git a/docs/manual/mod/mod_file_cache.html.en b/docs/manual/mod/mod_file_cache.html.en
index 5afa0294f5f..9f410e39986 100644
--- a/docs/manual/mod/mod_file_cache.html.en
+++ b/docs/manual/mod/mod_file_cache.html.en
@@ -1,8 +1,11 @@
-mod_file_cache- Apache HTTP Server
This module should be used with care. You can easily
@@ -30,7 +33,7 @@ This module should be used with care. You can easily
mod_mmap_static module in Apache 1.3.
mod_file_cache caches a list of statically
configured files via MMapFile or CacheFile directives in the
main server configuration.
@@ -46,7 +49,7 @@ This module should be used with care. You can easily
MmapFile Directive
The MmapFile
- directive of mod_file_cache maps a list of
+ directive of mod_file_cache maps a list of
statically configured files into memory through the system call
mmap(). This system call is available on most modern
Unix derivates, but not on all. There are sometimes
@@ -71,7 +74,7 @@ This module should be used with care. You can easily
CacheFile Directive
The CacheFile
- directive of mod_file_cache opens an active
+ directive of mod_file_cache opens an active
handle or file descriptor to the file (or files)
listed in the configuration directive and places these open file
handles in the cache. When the file is requested, the server
@@ -95,7 +98,7 @@ This module should be used with care. You can easily
Note
Don't bother asking for a for a
directive which recursively caches all the files in a
directory. Try this instead... See the
- Include directive, and consider
+ Include directive, and consider
this command:
find /www/htdocs -type f -print \
@@ -103,8 +106,13 @@ This module should be used with care. You can easily
The CacheFile directive opens handles to
one or more files (given as whitespace separated arguments) and
places these handles into the cache at server startup
@@ -118,13 +126,18 @@ This module should be used with care. You can easily
stuff to match paths through symbolic links etc.
because that again would cost extra stat() system
calls which is not acceptable. This module may or may not work
- with filenames rewritten by mod_alias or
- mod_rewrite.
The MMapFile directive maps one or more files
(given as whitespace separated arguments) into memory at server
startup time. They are automatically unmapped on a server
@@ -138,8 +151,8 @@ This module should be used with care. You can easily
stuff to match paths through symbolic links etc.
because that again would cost extra stat() system
calls which is not acceptable. This module may or may not work
- with filenames rewritten by mod_alias or
- mod_rewrite.
This directive can replace, merge or remove HTTP response
headers. The header is modified just after the content handler
and output filters are run, allowing outgoing headers to be
@@ -172,8 +182,14 @@ variable FOOBAR.
is sent to the network. These means that it is possible to set
and/or override most headers, except for those headers added by
the header filter.
-
This directive can replace, merge or remove HTTP request
headers. The header is modified just before the content handler
is run, allowing incoming headers to be modified. The action it
diff --git a/docs/manual/mod/mod_imap.html.en b/docs/manual/mod/mod_imap.html.en
index 7530daa266d..3ac9cc5855b 100644
--- a/docs/manual/mod/mod_imap.html.en
+++ b/docs/manual/mod/mod_imap.html.en
@@ -1,14 +1,17 @@
-
This module processes .map files, thereby
replacing the functionality of the imagemap CGI
program. Any directory or document type configured to use the
handler imap-file (using either
- AddHandler or
- SetHandler)
+ AddHandler or
+ SetHandler)
will be processed by this module.
The following directive will activate files ending with
@@ -220,14 +223,28 @@
<IMG ISMAP SRC="/images/imagemap1.gif">
</A>
The ImapBase directive sets the default
base used in the imagemap files. Its value is
overridden by a base directive within the imagemap
file. If not present, the base defaults to
http://servername/.
The ImapDefault directive sets the default
default used in the imagemap files. Its value is
overridden by a default directive within the
@@ -235,9 +252,15 @@ that are not explicitly mapped
This module provides a filter which will process files
before they are sent to the client. The processing is
@@ -11,7 +14,7 @@
inclusion of other files or programs, as well as the setting and
printing of environment variables.
Server Side Includes are implemented by the
@@ -137,7 +140,7 @@
The exec command executes a given shell command or CGI
- script. The IncludesNOEXEC Option disables this command
+ script. The IncludesNOEXEC Option disables this command
completely. The valid attributes are:
@@ -151,8 +154,8 @@
invoked as a CGI script, even if the server would not
normally recognize it as such. However, the directory
containing the script must be enabled for CGI scripts
- (with ScriptAlias
- or the ExecCGI Option).
+ (with ScriptAlias
+ or the ExecCGI Option).
The CGI script is given the PATH_INFO and query
string (QUERY_STRING) of the original request from the
@@ -520,10 +523,17 @@
Files processed for server-side includes no longer accept
requests with PATH_INFO (trailing pathname information) by
- default. You can use the AcceptPathInfo directive to
+ default. You can use the AcceptPathInfo directive to
configure the server to accept requests with PATH_INFO.
The SSIErrorMsg directive changes the error message displayed
when mod_include encounters an error. For production servers you
may consider changing the default error message to
@@ -549,8 +567,15 @@
SSIErrorMsg "<!-- Error -->"
This directive changes the format in which date strings are displayed
when echoing DATE environment variables. The formatstring
is as in strftime(3) from the C standard library.
The XBitHack directives controls the parsing of ordinary
html documents. This directive only affects files associated
with the MIME type text/html. XBitHack can take on
diff --git a/docs/manual/mod/mod_info.html.en b/docs/manual/mod/mod_info.html.en
index cea10d0a20d..c2921b544fa 100644
--- a/docs/manual/mod/mod_info.html.en
+++ b/docs/manual/mod/mod_info.html.en
@@ -1,11 +1,14 @@
-
mod_info- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_info
Description:
Provides a comprehensive overview of the server
-configuration
To configure mod_info, add the following to your
+
To configure mod_info, add the following to your
httpd.conf file.
@@ -15,9 +18,9 @@ SetHandler server-info
You may wish to add a
- <Limit>
+ <Limit>
clause inside the
- <location>
+ <location>
directive to limit access to your server configuration
information.
@@ -31,19 +34,25 @@ SetHandler server-info
configuration if the files have been changed since the server
was last reloaded. Also, the configuration files must be
readable by the user as which the server is running (see the
- User directive), or
+ User directive), or
else the directive settings will not be listed.
It should also be noted that if
- mod_info is compiled into the server, its
+ mod_info is compiled into the server, its
handler capability is available in all configuration
files, including per-directory files (e.g.,
.htaccess). This may have security-related
ramifications for your site.
This module implements the Internet Server extension API. It
allows Internet Server extensions (e.g. ISAPI .dll
modules) to be served by Apache for Windows, subject to the
@@ -15,7 +19,7 @@
extention. Please do not post such problems to
Apache's lists or bug reporting pages.
In the server configuration file, use
-the AddHandler directive to
+the AddHandler directive to
associate ISAPI files with the isapi-isa handler, and map
it to the with their file extensions. To enable any .dll file to be
processed as an ISAPI extention, edit the httpd.conf file and add the
@@ -69,7 +73,7 @@ following line:
Apache 2.0 mod_isapi supports additional
features introduced in later versions of the ISAPI specification,
as well as limited emulation of async I/O and the TransmitFile
semantics. Apache also supports preloading ISAPI .dlls for
performance, neither of which were not available under Apache 1.3
mod_isapi.
Specifies a space-separated list of file names to be loaded
when the Apache server is launched, and remain loaded until the
server is shut down. This directive may be repeated for every
ISAPI .dll file desired. The full path name of each file should
be specified.
Logs all requests for unsupported features from ISAPI
extensions in the server error log. While this should be turned
off once all desired ISAPI modules are functioning, it defaults
to on to help administrators track down problems.
Defines the maximum size of the Read Ahead Buffer sent to
ISAPI extensions when they are initially invoked. All remaining
data must be retrieved using the ReadClient callback; some
diff --git a/docs/manual/mod/mod_log_config.html.en b/docs/manual/mod/mod_log_config.html.en
index eafb46be8f9..077a73b8aed 100644
--- a/docs/manual/mod/mod_log_config.html.en
+++ b/docs/manual/mod/mod_log_config.html.en
@@ -1,8 +1,11 @@
-
This module provides for flexible logging of client
requests. Logs are written in a customizable format, and may be
@@ -190,18 +193,30 @@ this conflicted with the historical ssl %...{var}c syntax.)
The CookieLog directive sets the
filename for logging of cookies. The filename is relative to the
- serverroot. This directive is
- included only for compatibility with mod_cookies,
+ serverroot. This directive is
+ included only for compatibility with mod_cookies,
and is deprecated.
Nickname only available in Apache 1.3 or later.
Conditional logging available in 1.3.5 or later.
The CustomLog directive is used to
log requests to the server. A log format is specified, and the
@@ -254,8 +269,8 @@ Conditional logging available in 1.3.5 or later.
Environment variables can be set on a per-request
- basis using the mod_setenvif
- and/or mod_rewrite modules. For
+ basis using the mod_setenvif
+ and/or mod_rewrite modules. For
example, if you want to record requests for all GIF
images on your server in a separate logfile but not in your main
log, you can use:
@@ -265,9 +280,15 @@ Conditional logging available in 1.3.5 or later.
CustomLog nongif-requests.log common env=!gif-image
This directive has exactly the same arguments and effect as
the CustomLog directive, with the
diff --git a/docs/manual/mod/mod_mime.html.en b/docs/manual/mod/mod_mime.html.en
index 6bd0071bd9e..b93491caa5a 100644
--- a/docs/manual/mod/mod_mime.html.en
+++ b/docs/manual/mod/mod_mime.html.en
@@ -1,11 +1,14 @@
-
mod_mime- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_mime
Description:
Associates the requested filename's extensions
+mod_mime - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_mime
Description:
+
Associates the requested filename's extensions
with the file's behavior (handlers and filters)
and content (mime-type, language, character set and
- encoding)
This module is used to associate various bits of "meta
information" with files by their filename extensions. This
information relates the filename of the document to it's
@@ -13,7 +16,7 @@
information is sent to the browser, and participates in content
negotiation, so the user's preferences are respected when
choosing one of several possible files to serve. See
- mod_negotiation for more information
+ mod_negotiation for more information
about content negotiation.
The directives AddCharset, AddEncoding, AddLanguage and AddType are all used to map file
@@ -22,19 +25,19 @@
and MIME-type (content-type) of documents. The directive TypesConfig is used to specify a
file which also maps extensions onto MIME types.
Note that changing the meta-information for a file does not
change the value of the Last-Modified header.
@@ -44,7 +47,7 @@
encoding) you may need to 'touch' affected files (updating
their last modified date) to ensure that all visitors are
receive the corrected content headers.
Files can have more than one extension, and the order of the
@@ -126,16 +129,16 @@
The character set, language encoding and mime type are all
used in the process of content negotiation (See
- mod_negotiation) to determine
+ mod_negotiation) to determine
which document to give to the client, when there are
alternative documents in more than one character set, language,
encoding or mime type. All filename extensions associations
- created with AddCharset, AddEncoding,
- AddLanguage and AddType directives
- (and extensions listed in the MimeMagicFile)
+ created with AddCharset, AddEncoding,
+ AddLanguage and AddType directives
+ (and extensions listed in the MimeMagicFile)
participate in this select process. Filename extensions that
- are only associated using the AddHandler,
- AddInputFilter or AddOutputFilter
+ are only associated using the AddHandler,
+ AddInputFilter or AddOutputFilter
directives may be included or excluded from matching by using
the MultiviewsMatch directive.
@@ -158,9 +161,16 @@ Content-Type: text/plain; charset=ISO-8859-2
for the language. The charset is the name of the
particular character set which should be used.
-
The AddEncoding directive maps the given filename extensions
to the specified encoding type. MIME-enc is the MIME
@@ -228,9 +244,15 @@ Content-Type: text/plain; charset=ISO-8859-2
The extension argument is case-insensitive, and can
be specified with or without a leading dot.
Files having the name extension will be served by the
specified handler-name. This mapping is
added to any already in force, overriding any mappings that already
@@ -249,11 +271,17 @@ use:
The extension argument is case-insensitive, and can
be specified with or without a leading dot.
The AddLanguage directive maps the given filename extension
to the specified content language. MIME-lang is the
@@ -313,25 +347,32 @@ to the specified content language
AddOutputFilter
is only available in Apache 2.0.26 and later.
The AddOutputFilter directive maps the
filename extensions extension to the filters which will process responses
from the server before they are sent to the client. This is in
addition to any filters defined elsewhere, including the
- SetOutputFilter
+ SetOutputFilter
directive. This mapping is merged over any already in force,
overriding any mappings that already exist for the same
extension.
For example, the following configuration will process all
.shtml files for server-side includes and will then compress
- the output using mod_deflate.
The AddType directive maps the given filename extensions onto
the specified content type. MIME-type is the MIME type to
@@ -370,9 +417,16 @@ onto the specified content type
The TypesConfig directive sets the location of the MIME types
configuration file. Filename is relative to the ServerRoot. This file sets the
@@ -625,4 +736,4 @@ extensions
\ No newline at end of file
diff --git a/docs/manual/mod/mod_mime_magic.html.en b/docs/manual/mod/mod_mime_magic.html.en
index 1aaa1310705..5ae0a6107ab 100644
--- a/docs/manual/mod/mod_mime_magic.html.en
+++ b/docs/manual/mod/mod_mime_magic.html.en
@@ -1,13 +1,16 @@
-mod_mime_magic- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_mime_magic
Description:
Determines the MIME type of a file
- by looking at a few bytes of its contents
This module determines the MIME type of files in the same
way the Unix file(1) command works: it looks at the first few
bytes of the file. It is intended as a "second line of defense"
- for cases that mod_mime can't
+ for cases that mod_mime can't
resolve. To assure that mod_mime gets first try at determining
a file's MIME type, be sure to list mod_mime_magic
before mod_mime in the configuration.
The MimeMagicFile directive can be used to
enable this module, the default file is distributed at
conf/magic. Non-rooted paths are relative to the
diff --git a/docs/manual/mod/mod_setenvif.html.en b/docs/manual/mod/mod_setenvif.html.en
index 31033b8bc13..c86e73e4e30 100644
--- a/docs/manual/mod/mod_setenvif.html.en
+++ b/docs/manual/mod/mod_setenvif.html.en
@@ -1,9 +1,12 @@
-
mod_setenvif- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_setenvif
Description:
Allows the setting of environment variables based
-on characteristics of the request
The mod_setenvif module allows you to set
environment variables according to whether different aspects of
@@ -20,9 +23,15 @@ on characteristics of the request
The BrowserMatch is a special cases of the
SetEnvIf directive that
sets environment variables conditional on the
@@ -39,9 +48,16 @@ on characteristics of the request
The SetEnvIf directive defines
environment variables based on attributes of the request. The
attribute specified in the first argument can be one of three
@@ -162,10 +184,17 @@ of
The SetEnvIfNoCase is semantically identical to
the SetEnvIf directive,
diff --git a/docs/manual/mod/mod_so.html.en b/docs/manual/mod/mod_so.html.en
index 1be595bea3d..f924bc50e17 100644
--- a/docs/manual/mod/mod_so.html.en
+++ b/docs/manual/mod/mod_so.html.en
@@ -1,9 +1,12 @@
-
mod_so- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_so
Description:
Loading of executable code and
-modules into the server at start-up or restart time
On selected operating systems this module can be used to
load modules into Apache at runtime via the Dynamic Shared Object (DSO) mechanism,
@@ -89,7 +92,12 @@ modules into the server at start-up or restart time
The LoadFile directive links in the named object files or
libraries when the server is started or restarted; this is used
@@ -101,8 +109,13 @@ modules into the server at start-up or restart time
The LoadModule directive links in the object file or library
filename and adds the module structure named
module to the list of active modules. Module
diff --git a/docs/manual/mod/mod_speling.html.en b/docs/manual/mod/mod_speling.html.en
index 52ac2c69767..1b7df17a1f8 100644
--- a/docs/manual/mod/mod_speling.html.en
+++ b/docs/manual/mod/mod_speling.html.en
@@ -1,10 +1,13 @@
-
mod_speling- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_speling
Description:
Attempts to correct mistaken URLs that
+mod_speling - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_speling
Description:
+
Attempts to correct mistaken URLs that
users might have entered by ignoring capitalization and by
-allowing up to one misspelling
Requests to documents sometimes cannot be served by the core
apache server because the request was misspelled or
@@ -33,8 +36,16 @@ allowing up to one misspelling
CheckSpelling was available as a separately available
module for Apache 1.1, but was limited to miscapitalizations. As
of Apache 1.3, it is part of the Apache distribution. Prior to Apache
1.3.2, the CheckSpelling directive was only available in the
diff --git a/docs/manual/mod/mod_ssl.html.en b/docs/manual/mod/mod_ssl.html.en
index 5fb4cbbcd0d..885cd7e6e92 100644
--- a/docs/manual/mod/mod_ssl.html.en
+++ b/docs/manual/mod/mod_ssl.html.en
@@ -1,9 +1,12 @@
-mod_ssl- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_ssl
Description:
Strong cryptography using the Secure Sockets
-Layer (SSL) and Transport Layer Security (TLS) protocols
This module provides SSL v2/v3 and TLS v1 support for the Apache
HTTP Server. It was contributed by Ralf S. Engeschall based on his
mod_ssl project and originally derived from work by Ben Laurie.
This directive sets the all-in-one file where you can assemble the
Certificates of Certification Authorities (CA) whose clients you deal
@@ -102,8 +110,13 @@ preference. This can be used alternatively and/or additionally to
This directive sets the directory where you keep the Certificates of
Certification Authorities (CAs) whose clients you deal with. These are used to
@@ -118,8 +131,13 @@ comes with mod_ssl to accomplish this task.
This directive sets the all-in-one file where you can
assemble the Certificate Revocation Lists (CRL) of Certification
@@ -130,8 +148,13 @@ used alternatively and/or additionally to
This directive sets the directory where you keep the Certificate Revocation
Lists (CRL) of Certification Authorities (CAs) whose clients you deal with.
@@ -146,7 +169,12 @@ comes with mod_ssl to accomplish
This directive sets the optional all-in-one file where you can
assemble the certificates of Certification Authorities (CA) which form the
@@ -173,7 +201,12 @@ confused in this situation.
This directive points to the PEM-encoded Certificate file for the server and
optionally also to the corresponding RSA or DSA Private Key file for it
@@ -184,7 +217,12 @@ server certificate is used in parallel.
This directive points to the PEM-encoded Private Key file for the
server. If the Private Key is not combined with the Certificate in the
@@ -201,8 +239,15 @@ private key is used in parallel.
This complex directive uses a colon-separated cipher-spec string
consisting of OpenSSL cipher specifications to configure the Cipher Suite the
@@ -363,7 +408,13 @@ SSLCipherSuite RSA:!EXP:!NULL:+HIGH:+MEDIUM:-LOW
This directive toggles the usage of the SSL/TLS Protocol Engine. This
is usually used inside a <VirtualHost> section to enable SSL/TLS for a
@@ -375,8 +426,14 @@ SSLEngine on
...
</VirtualHost>
This configures the SSL engine's semaphore (aka. lock) which is used for mutual
exclusion of operations which have to be done in a synchronized way between the
@@ -413,7 +470,13 @@ The following Mutex types are available:
This directive can be used to control various run-time options on a
per-directory basis. Normally, if multiple SSLOptions
@@ -501,8 +564,14 @@ SSLOptions +FakeBasicAuth -StrictRequire
SSLOptions +StdEnvVars +CompatEnvVars -ExportCertData
<Files>
This directive can be used to control the SSL protocol flavors mod_ssl should
use when establishing its server environment. Clients then can only connect
@@ -597,8 +673,13 @@ The available (case-insensitive) protocols are:
# enable SSLv3 and TLSv1, but not SSLv2
SSLProtocol all -SSLv2
This directive sets the all-in-one file where you can assemble the
Certificates of Certification Authorities (CA) whose remote servers you deal
@@ -609,8 +690,13 @@ preference. This can be used alternatively and/or additionally to
This directive sets the directory where you keep the Certificates of
Certification Authorities (CAs) whose remote servers you deal with. These are used to
@@ -625,8 +711,13 @@ comes with mod_ssl to accomplish this task.
This directive sets the all-in-one file where you can
assemble the Certificate Revocation Lists (CRL) of Certification
@@ -637,8 +728,13 @@ used alternatively and/or additionally to
This directive sets the directory where you keep the Certificate Revocation
Lists (CRL) of Certification Authorities (CAs) whose remote servers you deal with.
@@ -653,12 +749,25 @@ comes with mod_ssl to accomplish
This directive toggles the usage of the SSL/TLS Protocol Engine for proxy. This
is usually used inside a <VirtualHost> section to enable SSL/TLS for proxy
@@ -670,7 +779,14 @@ SSLProxyEngine on
...
</VirtualHost>
This directive sets the directory where you keep the certificates of
Certification Authorities (CAs) whose proxy client certificates are used for
@@ -686,7 +802,14 @@ Example:
This directive sets the directory where you keep the certificates of
Certification Authorities (CAs) whose proxy client certificates are used for
@@ -703,7 +826,14 @@ Example:
This directive sets the Certificate verification level for the remote server
Authentication. Notice that this directive can be used both in per-server and
@@ -742,8 +879,15 @@ authentication (but can be used to establish SSL test pages, etc.)
This directive sets how deeply mod_ssl should verify before deciding that the
remote server does not have a valid certificate. Notice that this directive can be
@@ -763,9 +907,14 @@ which is directly known to the server (i.e. the CA's certificate is under
This configures one or more sources for seeding the Pseudo Random Number
Generator (PRNG) in OpenSSL at startup time (context is
@@ -848,8 +997,14 @@ SSLRandomSeed connect builtin
SSLRandomSeed connect file:/dev/random
SSLRandomSeed connect file:/dev/urandom 1024
This directive specifies a general access requirement which has to be
fulfilled in order to allow access. It's a very powerful directive because the
@@ -981,8 +1136,14 @@ SSL_VERSION_INTERFACE SSL_CLIENT_S_DN_OU SSL_SERVER_S_DN_OU
This directive forbids access unless HTTP over SSL (i.e. HTTPS) is enabled for
the current connection. This is very handy inside the SSL-enabled virtual
@@ -992,8 +1153,14 @@ are denied which are not using SSL.
This configures the storage type of the global/inter-process SSL Session
Cache. This cache is an optional facility which speeds up parallel request
@@ -1030,8 +1197,14 @@ The following two storage types are currently supported:
This directive sets the timeout in seconds for the information stored in the
global/inter-process SSL Session Cache and the OpenSSL internal memory cache.
@@ -1040,7 +1213,14 @@ values like 300 in real life.
This directive sets the Certificate verification level for the Client
Authentication. Notice that this directive can be used both in per-server and
@@ -1070,8 +1250,15 @@ authentication (but can be used to establish SSL test pages, etc.)
This directive sets how deeply mod_ssl should verify before deciding that the
clients don't have a valid certificate. Notice that this directive can be
diff --git a/docs/manual/mod/mod_status.html.en b/docs/manual/mod/mod_status.html.en
index 05f3e6a5c8e..d4d58439d3b 100644
--- a/docs/manual/mod/mod_status.html.en
+++ b/docs/manual/mod/mod_status.html.en
@@ -1,9 +1,12 @@
-
mod_status- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_status
Description:
Provides information on server activity and
-performance
- It should be noted that if mod_status is
+ It should be noted that if mod_status is
compiled into the server, its handler capability is available
in all configuration files, including
per-directory files (e.g.,
@@ -98,9 +101,16 @@ performance
This directive controls whether the server keeps track of
extended status information for each request. This is only
-useful if the status module is enabled on the server.
SuexecUserGroup is only available in 2.0 and
later.
The SuexecUserGroup directive allows you
to specify a user and group for CGI programs to run as. Non-CGI
diff --git a/docs/manual/mod/mod_unique_id.html.en b/docs/manual/mod/mod_unique_id.html.en
index 46d6cd8a5b1..3b9a751555b 100644
--- a/docs/manual/mod/mod_unique_id.html.en
+++ b/docs/manual/mod/mod_unique_id.html.en
@@ -1,9 +1,12 @@
-
mod_unique_id- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_unique_id
Description:
Provides an environment variable with a unique
-identifier for each request
This module provides a magic token for each request which is
guaranteed to be unique across "all" requests under very
diff --git a/docs/manual/mod/mod_usertrack.html.en b/docs/manual/mod/mod_usertrack.html.en
index 4cb2985365e..ee6a5a3c765 100644
--- a/docs/manual/mod/mod_usertrack.html.en
+++ b/docs/manual/mod/mod_usertrack.html.en
@@ -1,10 +1,13 @@
-
Previous releases of Apache have included a module which
generates a 'clickstream' log of user activity on a site using
cookies. This was called the "cookies" module, mod_cookies. In
@@ -27,8 +30,8 @@ CustomLog logs/clickstream "%{cookie}n %r %t"
For backward compatibility the configurable log module
- implements the old CookieLog directive, but this
- should be upgraded to the above CustomLog directive.
+ implements the old CookieLog directive, but this
+ should be upgraded to the above CustomLog directive.
2-digit or 4-digit dates for cookies?
@@ -68,7 +71,13 @@ form, but also understands 4-digit years, which can probably reach up until
time late in the year "37".
-
This directive controls the setting of the domain to which
the tracking cookie applies. If not present, no domain is
@@ -77,7 +86,13 @@ time late in the year "37".
The domain string must begin with a dot, and
must include at least one embedded dot. That is,
".foo.com" is legal, but "foo.bar.com" and ".com" are not.
When used, this directive sets an expiry time on the cookie
generated by the usertrack module. The expiry-period
can be given either as a number of seconds, or in the format
@@ -88,7 +103,14 @@ time late in the year "37".
If this directive is not used, cookies last only for the
current browser session.
This directive allows you to change the name of the cookie
this module uses for its tracking purposes. By default the
cookie is named "Apache".
@@ -96,8 +118,15 @@ time late in the year "37".
You must specify a valid cookie name; results are
unpredictable if you use a name containing unusual characters.
Valid characters include A-Z, a-z, 0-9, "_", and "-".
When the user track module is compiled in, and
"CookieTracking on" is set, Apache will start sending a
user-tracking cookie for all new requests. This directive can
diff --git a/docs/manual/mod/mod_vhost_alias.html.en b/docs/manual/mod/mod_vhost_alias.html.en
index f5037a4afd4..5776390ef17 100644
--- a/docs/manual/mod/mod_vhost_alias.html.en
+++ b/docs/manual/mod/mod_vhost_alias.html.en
@@ -1,9 +1,12 @@
-
mod_vhost_alias- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mod_vhost_alias
Description:
Provides for dynamically configured mass virtual
-hosting
The VirtualDocumentRoot directive allows you to
determine where Apache will find your documents based on the
value of the server name. The result of expanding
interpolated-directory is used as the root of the
- document tree in a similar manner to the DocumentRoot directive's argument.
+ document tree in a similar manner to the DocumentRoot directive's argument.
If interpolated-directory is none then
VirtaulDocumentRoot is turned off. This directive
cannot be used in the same context as
VirtualDocumentRootIP.
The VirtualDocumentRootIP directive is like the
VirtualDocumentRoot
directive, except that it uses the IP address of the server end
of the connection instead of the server name.
The VirtualScriptAlias directive allows you to
determine where Apache will find CGI scripts in a similar
manner to VirtualDocumentRoot
does for other documents. It matches requests for URIs starting
- /cgi-bin/, much like ScriptAlias
+ /cgi-bin/, much like ScriptAlias/cgi-bin/ would.
The VirtualScriptAliasIP directive is like the
VirtualScriptAlias
diff --git a/docs/manual/mod/mpm_common.html.en b/docs/manual/mod/mpm_common.html.en
index d172392d90c..347c368cd02 100644
--- a/docs/manual/mod/mpm_common.html.en
+++ b/docs/manual/mod/mpm_common.html.en
@@ -1,10 +1,18 @@
-
mpm_common- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mpm_common
Description:
A collection of directives that are implemented by
-more than one multi-processing module (MPM)
This controls the directory to which Apache attempts to
switch before dumping core. The default is in the
@@ -13,8 +21,14 @@ switch before dumping core
The Group directive sets the group under
which the server will answer requests. In order to use this
directive, the stand-alone server must be run initially as root.
@@ -42,8 +56,13 @@ requests
SuexecUserGroup
directive. SECURITY: See User for a discussion of the
security considerations.
-
The Listen directive instructs Apache to
listen to only specific IP addresses or ports; by default it
responds to requests on all IP interfaces. The Listen directive is
@@ -80,7 +99,13 @@ listens to
The maximum length of the queue of pending connections.
Generally no tuning is needed or desired, however on some
systems it is desirable to increase this when under a TCP SYN
@@ -92,7 +117,13 @@ listens to
The LockFile directive sets the path to
the lockfile used when Apache is compiled with either
USE_FCNTL_SERIALIZED_ACCEPT or USE_FLOCK_SERIALIZED_ACCEPT. This
@@ -108,9 +139,15 @@ listens to
The MaxClients directive sets the limit
on the number of child processes that will be created to serve
requests. When the server is built without threading, no more than
@@ -131,8 +168,14 @@ to serve requests
The MaxRequestsPerChild directive sets
the limit on the number of requests that an individual child
server process will handle. After
@@ -155,7 +198,12 @@ will handle during its life
Maximum number of threads per child. For MPMs with a
variable number of threads per child, this directive sets the
maximum number of threads that will be created in each child
process. To increase this value beyond its default, it is
necessary to change the value of the compile-time define
HARD_THREAD_LIMIT and recompile the server.
Number of children alive at the same time. MPMs that use
this directive do not dynamically create new child processes so
this number should be large enough to handle the requests for
the entire site.
The PidFile directive sets the file to
which the server records the process id of the daemon. If the
filename does not begin with a slash (/) then it is assumed to be
@@ -228,8 +299,14 @@ of the daemon
Apache uses a scoreboard to communicate between its parent
and child processes. Some architectures require a file to facilitate
this communication. If the file is left unspecified, Apache first
@@ -249,12 +326,23 @@ the child processes
The server will set the TCP buffer size to the number of bytes
specified. Very useful to increase past standard OS defaults on
high speed high latency (i.e., 100ms or so, such as
transcontinental fast pipes).
For the prefork MPM, this directive sets the
maximum configured value for MaxClients for the lifetime of the
Apache process. For the worker MPM, this directive in combination
@@ -282,12 +370,23 @@ the child processes
The StartServers directive sets the
number of child server processes created on startup. As the number
of processes is dynamically controlled depending on the load,
there is usually little reason to adjust this parameter.
Number of threads created on startup. As the
number of threads is dynamically controlled depending on the
load, there is usually little reason to adjust this
@@ -302,8 +401,14 @@ the child processes
This directive sets the maximum configured value for ThreadsPerChild for the lifetime
of the Apache process. Any attempts to change this directive
during a restart will be ignored, but ThreadsPerChild can be modified
@@ -320,7 +425,13 @@ per child process
ThreadsPerChild higher than 64. Do
not set the value of this directive any higher than what you might
want to set ThreadsPerChild to.
-
This directive sets the number of threads created by each
child process. The child creates these threads at startup and
never creates more. If using an MPM like mpmt_winnt, where
@@ -329,8 +440,14 @@ per child process
The User directive sets the userid as
which the server will answer requests. In order to use this
directive, the standalone server must be run initially as
diff --git a/docs/manual/mod/mpm_netware.html.en b/docs/manual/mod/mpm_netware.html.en
index ee29586f3fc..3d85fbae8e6 100644
--- a/docs/manual/mod/mpm_netware.html.en
+++ b/docs/manual/mod/mpm_netware.html.en
@@ -1,9 +1,12 @@
-
mpm_netware- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mpm_netware
Description:
Multi-Processing Module implementing an exclusively threaded web
- server optimized for Novell NetWare
This directive tells the server what stack size to use for
each of the running threads. If you ever get a stack overflow
you will need to bump this number to a higher setting.
diff --git a/docs/manual/mod/mpm_winnt.html.en b/docs/manual/mod/mpm_winnt.html.en
index 2e67fd31203..dc226bf6497 100644
--- a/docs/manual/mod/mpm_winnt.html.en
+++ b/docs/manual/mod/mpm_winnt.html.en
@@ -1,9 +1,12 @@
-mpm_winnt- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module mpm_winnt
Description:
This Multi-Processing Module is optimized for Windows
- NT.
This Multi-Processing Module (MPM) is the default for the
Windows NT operating systems. It uses a single control process
which launches a single child process which in turn creates
diff --git a/docs/manual/mod/perchild.html.en b/docs/manual/mod/perchild.html.en
index 4f4e80bb3d5..9466dae29e7 100644
--- a/docs/manual/mod/perchild.html.en
+++ b/docs/manual/mod/perchild.html.en
@@ -1,10 +1,13 @@
-
perchild- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module perchild
Description:
Multi-Processing Module allowing for daemon processes
+perchild - Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module perchild
Description:
+
Multi-Processing Module allowing for daemon processes
serving requests to be assigned a variety of different
- userids
This MPM does not currently work on most platforms. Work is ongoing to
make it functional.
@@ -17,9 +20,9 @@ make it functional.
threads in each process.
A single control process launches the number of child processes
- indicated by the NumServers directive at server
+ indicated by the NumServers directive at server
startup. Each child process creates threads as specified in the
- StartThreads directive.
+ StartThreads directive.
The individual threads then
listen for connections and serve them when they arrive.
@@ -29,27 +32,27 @@ make it functional.
threads to be created. For each child process, Apache assesses
the number of idle threads and creates or destroys threads to
keep this number within the boundaries specified by
- MinSpareThreads
- and MaxSpareThreads.
+ MinSpareThreads
+ and MaxSpareThreads.
Since this process is very self-regulating, it is rarely
necessary to modify these directives from their default values.
The maximum number of clients that may be served simultaneously
is determined by multiplying the number of server processes
- that will be created (NumServers) by the maximum
+ that will be created (NumServers) by the maximum
number of threads created in each process
- (MaxThreadsPerChild).
+ (MaxThreadsPerChild).
While the parent process is usually started as root under
Unix in order to bind to port 80, the child processes and
threads are launched by Apache as a less-privileged user. The
- User and Group directives are used to
+ User and Group directives are used to
set the privileges of the Apache child processes. The child
processes must be able to read all the content that will be
served, but should have as few privileges beyond that as
possible. In addition, unless suexec is used, these directives also
set the privileges which will be inherited by CGI scripts.
Tie a virtual host to a specific child process. Requests addressed to
the virtual host where this directive appears will be served by the process
running with the specified user and group id.
Specify a user id and group id for a specific child process. The number of
-children is set by the NumServers
-directive. For example, the default value for NumServers is 5 and that means
+children is set by the NumServers
+directive. For example, the default value for NumServers is 5 and that means
children ids 1,2,3,4 and 5 are available for assigment. If a child does not
-have an associated ChildPerUserID, it inherits the User and Group settings from the main server
+have an associated ChildPerUserID, it inherits the User and Group settings from the main server
Apache HTTP Server Version 2.0
\ No newline at end of file
diff --git a/docs/manual/mod/prefork.html.en b/docs/manual/mod/prefork.html.en
index 9e9f700ec98..7c4625c090e 100644
--- a/docs/manual/mod/prefork.html.en
+++ b/docs/manual/mod/prefork.html.en
@@ -1,8 +1,11 @@
-prefork- Apache HTTP Server
This Multi-Processing Module (MPM) implements a non-threaded,
pre-forking web server that handles requests in a manner similar
to Apache 1.3. It is appropriate for sites that need to avoid
@@ -12,7 +15,7 @@
This MPM is very self-regulating, so it is rarely necessary to
adjust its configuration directives. Most important is that
- MaxClients be big enough to
+ MaxClients be big enough to
handle as many simultaneous requests as you expect to receive, but
small enough to assure that there is enough physical RAM for all
processes.
@@ -27,32 +30,38 @@
child processes to be forked before their requests can be
served.
-
The StartServers,
MinSpareServers,
MaxSpareServers, and
- MaxClients regulate how
+ MaxClients regulate how
the parent process creates children to serve requests. In general,
Apache is very self-regulating, so most sites do not need to
adjust these directives from their default values. Sites which
need to serve more than 256 simultaneous requests may need to
- increase MaxClients,
- while sites with limited memory may need to decrease MaxClients to keep the server from
+ increase MaxClients,
+ while sites with limited memory may need to decrease MaxClients to keep the server from
thrashing (swapping memory to disk and back). More information
about tuning process creation is provided in the performance hints
documentation.
While the parent process is usually started as root under Unix
in order to bind to port 80, the child processes are launched by
- Apache as a less-privileged user. The User and Group directives are used to set
+ Apache as a less-privileged user. The User and Group directives are used to set
the privileges of the Apache child processes. The child processes
must be able to read all the content that will be served, but
should have as few privileges beyond that as possible.
The AcceptMutex directives sets the
method that Apache uses to serialize multiple children accepting
requests on network sockets. Prior to Apache 2.0, the method was
@@ -72,12 +81,12 @@ accepting requests on network sockets
The MaxSpareServers directive sets the
desired maximum number of idle child server processes. An
idle process is one which is not handling a request. If there are
@@ -98,7 +113,13 @@ accepting requests on network sockets
The MinSpareServers directive sets the
desired minimum number of idle child server processes. An
idle process is one which is not handling a request. If there are
@@ -108,4 +129,4 @@ accepting requests on network sockets
\ No newline at end of file
diff --git a/docs/manual/mod/worker.html.en b/docs/manual/mod/worker.html.en
index 4f8ba4ead5b..0db3f3b976b 100644
--- a/docs/manual/mod/worker.html.en
+++ b/docs/manual/mod/worker.html.en
@@ -1,9 +1,12 @@
-worker- Apache HTTP Server
Apache HTTP Server Version 2.0
Apache Module worker
Description:
Multi-Processing Module implementing a hybrid
- multi-threaded multi-process web server
This Multi-Processing Module (MPM) implements a hybrid
multi-process multi-threaded server. By using threads to serve
requests, it is able to serve a large number of requests with
@@ -12,8 +15,8 @@
keeping multiple processes available, each with many threads.
The most important directives used to control this MPM are
- ThreadsPerChild and
- MaxClients. By multiplying
+ ThreadsPerChild and
+ MaxClients. By multiplying
together the value of these directives you define the total number
of simultaneous connections that the server can handle.
@@ -25,7 +28,7 @@
A single control process is responsible for launching child
processes. Each child process creates a fixed number of threads as
- specified in the ThreadsPerChild directive. The
+ specified in the ThreadsPerChild directive. The
individual threads then listen for connections and serve them when
they arrive.
@@ -35,17 +38,17 @@
threads or processes to be created before their requests can be
served. Apache assesses the total number of idle threads in all
processes, and forks or kills processes to keep this number within
- the boundaries specified by MinSpareThreads and MaxSpareThreads. Since this
+ the boundaries specified by MinSpareThreads and MaxSpareThreads. Since this
process is very self-regulating, it is rarely necessary to modify
these directives from their default values. The maximum number of
clients that may be served simultaneously is determined by
multiplying the maximum number of server processes that will be
- created (MaxClients) by
- the number of threads created in each process (ThreadsPerChild).
+ created (MaxClients) by
+ the number of threads created in each process (ThreadsPerChild).
While the parent process is usually started as root under Unix
in order to bind to port 80, the child processes and threads are
- launched by Apache as a less-privileged user. The User and Group directives are used to set
+ launched by Apache as a less-privileged user. The User and Group directives are used to set
the privileges of the Apache child processes. The child processes
must be able to read all the content that will be served, but
should have as few privileges beyond that as possible. In
@@ -53,7 +56,7 @@
these directives also set the privileges which will be inherited
by CGI scripts.