diff --git a/docs/manual/mod/core.html.en b/docs/manual/mod/core.html.en index 83adf96e9a..5ba53e4e74 100644 --- a/docs/manual/mod/core.html.en +++ b/docs/manual/mod/core.html.en @@ -149,8 +149,8 @@ available

The default protocol names are https for port 443 - and http for all other ports. To specify another protocol - is being used with a listening port, add the protocol + and http for all other ports. To specify that another + protocol is being used with a listening port, add the protocol argument to the Listen directive.

@@ -164,7 +164,7 @@ AcceptFilter https dataready sends it to the server. See the accf_http(9) man page for more details. Since HTTPS requests are - encrypted only the + encrypted, only the accf_data(9) filter is used.

The default values on Linux are:

@@ -282,7 +282,7 @@ AcceptFilter https data Status:Core Module:core -

While processing a request the server looks for +

While processing a request, 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 configuration files are enabled for that @@ -291,11 +291,11 @@ AcceptFilter https data 

AccessFileName .acl
-

before returning the document +

Before returning the document /usr/local/web/index.html, the server will read /.acl, /usr/.acl, /usr/local/.acl and /usr/local/web/.acl - for directives, unless they have been disabled with

+ for directives unless they have been disabled with:

<Directory "/">
     AllowOverride None
@@ -369,7 +369,7 @@ NoDecode option available in 2.3.12 and later.
 
     
The AllowEncodedSlashes directive allows URLs
     which contain encoded path separators (%2F for /
-    and additionally %5C for \ on according systems)
+    and additionally %5C for \ on accordant systems)
     to be used in the path info.

 
     
With the default value, Off, such URLs are refused
@@ -408,7 +408,7 @@ NoDecode option available in 2.3.12 and later.
 Module:core
 
     
When the server finds an .htaccess file (as
-    specified by AccessFileName)
+    specified by AccessFileName),
     it needs to know which directives declared in that file can override
     earlier configuration directives.

 
@@ -420,7 +420,7 @@ NoDecode option available in 2.3.12 and later.
     
 
     
When this directive is set to None and AllowOverrideList is set to
-    None .htaccess files are
+    None, .htaccess files are
     completely ignored. In this case, the server will not even attempt
     to read .htaccess files in the filesystem.

 
@@ -482,16 +482,16 @@ NoDecode option available in 2.3.12 and later.
 
       

       Allow use of AllowOverride option to treat syntax errors in
-      .htaccess as non-fatal: instead of causing an Internal Server
+      .htaccess as nonfatal. Instead of causing an Internal Server
       Error, disallowed or unrecognised directives will be ignored
       and a warning logged:
       
       
Note that a syntax error in a valid directive will still cause
       an internal server error.

@@ -508,8 +508,8 @@ NoDecode option available in 2.3.12 and later.
       Allow use of the directives controlling specific directory
       features (Options and
       XBitHack).
-      An equal sign may be given followed by a comma (but no spaces)
-      separated lists of options that may be set using the Options command.
+      An equal sign may be given followed by a comma-separated list, without
+      spaces, of options that may be set using the Options command.
 
       
Implicit disabling of Options

       
Even though the list of options that may be used in .htaccess files
@@ -530,7 +530,7 @@ NoDecode option available in 2.3.12 and later.
     
AllowOverride AuthConfig Indexes

 
 
-    
In the example above all directives that are neither in the group
+    
In the example above, all directives that are neither in the group
     AuthConfig nor Indexes cause an internal
     server error.

 
@@ -563,7 +563,7 @@ NoDecode option available in 2.3.12 and later.
 Module:core
 
     
When the server finds an .htaccess file (as
-    specified by AccessFileName)
+    specified by AccessFileName),
     it needs to know which directives declared in that file can override
     earlier configuration directives.

 
@@ -585,7 +585,7 @@ NoDecode option available in 2.3.12 and later.
 AllowOverrideList Redirect RedirectMatch
-

In the example above only the Redirect and +

In the example above, only the Redirect and RedirectMatch directives are allowed. All others will cause an internal server error.

@@ -595,7 +595,7 @@ AllowOverrideList Redirect RedirectMatch AllowOverrideList CookieTracking CookieName -

In the example above AllowOverride +

In the example above, AllowOverride grants permission to the AuthConfig directive grouping and AllowOverrideList grants permission to only two directives from the FileInfo directive @@ -644,8 +644,8 @@ variables

CGIPassAuth allows scripts access to HTTP authorization headers such as Authorization, which is required for scripts that implement HTTP Basic authentication. - Normally these HTTP headers are hidden from scripts, as it allows - scripts to see user ids and passwords used to access the server when + Normally these HTTP headers are hidden from scripts. This is to disallow + scripts from seeing user ids and passwords used to access the server when HTTP Basic authentication is enabled in the web server. This directive should be used when scripts are allowed to implement HTTP Basic authentication.

@@ -730,7 +730,7 @@ headers at build time.

Note: ServerRoot should be specified before this - directive is used, otherwise the default value of ServerRoot + directive is used. Otherwise, the default value of ServerRoot would be used to set the base directory.

@@ -1356,7 +1356,7 @@ ErrorDocument 403 /cgi-bin/forbidden.pl?referrer=%{escape:%{HTTP_REFERER}} URL in an ErrorDocument 401, the client will not know to prompt the user for a password since it will not receive the 401 status code. Therefore, if you use an - ErrorDocument 401 directive then it must refer to a local + ErrorDocument 401 directive, then it must refer to a local document.

Microsoft Internet Explorer (MSIE) will by default ignore @@ -1427,7 +1427,7 @@ ErrorDocument 403 /cgi-bin/forbidden.pl?referrer=%{escape:%{HTTP_REFERER}}

Additional modules can provide their own ErrorLog providers. The syntax - is similar to syslog example above.

+ is similar to the syslog example above.

SECURITY: See the security tips document for details on why your security could be compromised @@ -1585,7 +1585,7 @@ ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M" or request. This can be used to correlate which log lines belong to the same connection or request, which request happens on which connection. A %L format string is also available in - mod_log_config, to allow to correlate access log entries + mod_log_config to allow to correlate access log entries with error log lines. If mod_unique_id is loaded, its unique id will be used as log ID for requests.

@@ -1634,12 +1634,12 @@ request Module:core

This option tracks additional data per worker about the - currently executing request, and a utilization summary; you - can see these variables during runtime by configuring + currently executing request and creates a utilization summary. + You can see these variables during runtime by configuring mod_status. Note that other modules may rely on this scoreboard.

-

This setting applies to the entire server, and cannot be +

This setting applies to the entire server and cannot be enabled or disabled on a virtualhost-by-virtualhost basis. The collection of extended status information can slow down the server. Also note that this setting cannot be changed @@ -1651,7 +1651,7 @@ request third party modules may do the same. Such modules rely on collecting detailed information about the state of all workers. The default is changed by mod_status beginning - with version 2.3.6; the previous default was always Off.

+ with version 2.3.6. The previous default was always Off.

@@ -1717,7 +1717,7 @@ earlier. changed via FileETag.

Server Side Includes

- An ETag is not generated for responses parsed by mod_include, + An ETag is not generated for responses parsed by mod_include since the response entity can change without a change of the INode, MTime, or Size of the static file with embedded SSI directives.
@@ -2258,7 +2258,7 @@ the server configuration files encoding will be used in order to send content of unknown length over persistent connections.

-

When a client uses a Keep-Alive connection it will be counted +

When a client uses a Keep-Alive connection, it will be counted as a single "request" for the MaxConnectionsPerChild directive, regardless of how many requests are sent using the connection.

@@ -2331,7 +2331,7 @@ methods PATCH, PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, and UNLOCK. The method name is - case-sensitive. If GET is used it will also + case-sensitive. If GET is used, it will also restrict HEAD requests. The TRACE method cannot be limited (see TraceEnable).

@@ -2421,8 +2421,8 @@ subrequests

The directive stores two different limits, which are evaluated on per-request basis. The first number is the maximum number of - internal redirects, that may follow each other. The second number - determines, how deep subrequests may be nested. If you specify only one + internal redirects that may follow each other. The second number + determines how deeply subrequests may be nested. If you specify only one number, it will be assigned to both limits.

LimitInternalRecursion 5
@@ -2465,7 +2465,7 @@ from the client attacks.

If, for example, you are permitting file upload to a particular - location, and wish to limit the size of the uploaded file to 100K, + location and wish to limit the size of the uploaded file to 100K, you might use the following directive:

LimitRequestBody 102400
@@ -2728,7 +2728,7 @@ URLs

The <Location> functionality is especially useful when combined with the SetHandler - directive. For example, to enable status requests, but allow them + directive. For example, to enable status requests but allow them only from browsers at example.com, you might use:

<Location "/status">
@@ -2985,7 +2985,7 @@ matching URLs
 
 
     
Note

-      
When logging to a regular file messages of the level
+      
When logging to a regular file, messages of the level
       notice cannot be suppressed and thus are always
       logged. However, this doesn't apply when logging is done
       using syslog.

@@ -3069,9 +3069,9 @@ LogLevel info ssl_module:warn
- LogLevelOverride only affects + LogLevelOverride only affects log messages that are associated with the request or the connection. - Log messages which are associated with the server not affected. + Log messages which are associated with the server are not affected.
@@ -3209,19 +3209,19 @@ resource
top

MergeTrailers Directive

- + - +
Description:Determins whether trailers are merged into headers
Description:Determines whether trailers are merged into headers
Syntax:MergeTrailers [on|off]
Default:MergeTrailers off
Context:server config, virtual host
Status:Core
Module:core
Compatibility:2.4.10 and later
Compatibility:2.4.11 and later

This directive controls whether HTTP trailers are copied into the - internal representation of HTTP headers. This mergeing occurs when the + internal representation of HTTP headers. This merging occurs when the request body has been completely consumed, long after most header processing would have a chance to examine or modify request headers.

-

This option is provided for compatibility with releases prior to 2.4.10, +

This option is provided for compatibility with releases prior to 2.4.11, where trailers were always merged.

@@ -3240,8 +3240,8 @@ or specified mutexes

The Mutex directive sets the mechanism, and optionally the lock file location, that httpd and modules use to serialize access to resources. Specify default as - the first argument to change the settings for all mutexes; specify - a mutex name (see table below) as the first argument to override + the second argument to change the settings for all mutexes; specify + a mutex name (see table below) as the second argument to override defaults only for that mutex.

The Mutex directive is typically used in @@ -3364,7 +3364,7 @@ or specified mutexes on a NFS- or AFS-filesystem. The basename of the file will be the mutex type, an optional instance string provided by the module, and unless the OmitPID keyword is specified, the process id of the httpd - parent process will be appended to to make the file name unique, avoiding + parent process will be appended to make the file name unique, avoiding conflicts when multiple httpd instances share a lock file directory. For example, if the mutex name is mpm-accept and the lock file directory is /var/httpd/locks, the lock file name for the @@ -3541,7 +3541,7 @@ directory

Indexes
- If a URL which maps to a directory is requested, and there + If a URL which maps to a directory is requested and there is no DirectoryIndex (e.g., index.html) in that directory, then mod_autoindex will return a formatted listing @@ -3588,7 +3588,7 @@ directory

Note

Mixing Options with a + or - - with those without is not valid syntax, and will be + - with those without is not valid syntax and will be rejected during server startup by the syntax check with an abort.

@@ -3639,16 +3639,19 @@ directory Context:server config, virtual host Status:Core Module:core -Compatibility:On Windows only available from Apache 2.3.3 and later. +Compatibility:On Windows, only available from Apache 2.3.3 and later.

This directive specifies the protocol used for a specific listening socket. - The protocol is used to determine which module should handle a request, and + The protocol is used to determine which module should handle a request and to apply protocol specific optimizations with the AcceptFilter directive.

-

You only need to set the protocol if you are running on non-standard ports, otherwise http is assumed for port 80 and https for port 443.

+

You only need to set the protocol if you are running on non-standard ports; + otherwise, http is assumed for port 80 and https + for port 443.

-

For example, if you are running https on a non-standard port, specify the protocol explicitly:

+

For example, if you are running https on a non-standard port, + specify the protocol explicitly:

Protocol https
@@ -3674,7 +3677,7 @@ directory rejected by request processing in Apache HTTPD. To avoid this, modules can register non-standard HTTP methods they support. The RegisterHttpMethod allows to register such -methods manually. This can be useful for if such methods are forwared +methods manually. This can be useful if such methods are forwarded for external processing, e.g. to a CGI script.

@@ -3696,13 +3699,13 @@ by Apache httpd children or max to indicate to the server that the limit should be set to the maximum allowed by the operating system configuration. Raising the maximum resource limit requires that - the server is running as root, or in the initial startup + the server is running as root or in the initial startup phase.

-

This applies to processes forked off from Apache httpd children +

This applies to processes forked from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any - processes forked off from the Apache httpd parent such as piped + processes forked from the Apache httpd parent, such as piped logs.

CPU resource limits are expressed in seconds per @@ -3732,13 +3735,13 @@ by Apache httpd children or max to indicate to the server that the limit should be set to the maximum allowed by the operating system configuration. Raising the maximum resource limit requires that - the server is running as root, or in the initial startup + the server is running as root or in the initial startup phase.

-

This applies to processes forked off from Apache httpd children +

This applies to processes forked from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any - processes forked off from the Apache httpd parent such as piped + processes forked from the Apache httpd parent, such as piped logs.

Memory resource limits are expressed in bytes per @@ -3763,18 +3766,18 @@ processes launched by Apache httpd children Module:core

Takes 1 or 2 parameters. The first parameter sets the soft - resource limit for all processes and the second parameter sets + resource limit for all processes, and the second parameter sets the maximum resource limit. Either parameter can be a number, or max to indicate to the server that the limit should be set to the maximum allowed by the operating system configuration. Raising the maximum resource limit requires that - the server is running as root, or in the initial startup + the server is running as root or in the initial startup phase.

-

This applies to processes forked off from Apache httpd children +

This applies to processes forked from Apache httpd children servicing requests, not the Apache httpd children themselves. This includes CGI scripts and SSI exec commands, but not any - processes forked off from the Apache httpd parent such as piped + processes forked from the Apache httpd parent, such as piped logs.

Process limits control the number of processes per user.

@@ -4193,10 +4196,9 @@ header minimal is not recommended because it makes it more difficult to debug interoperational problems. Also note that disabling the Server: header does nothing at all to make your - server more secure; the idea of "security through obscurity" + server more secure. The idea of "security through obscurity" is a myth and leads to a false sense of safety. -

See also