From: Takashi Sato Date: Sun, 25 May 2008 03:28:34 +0000 (+0000) Subject: Style fix. Almost all are detabs. X-Git-Tag: 2.3.0~587 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f32647d426199813af2fb93e913ccb4138ef1525;p=thirdparty%2Fapache%2Fhttpd.git Style fix. Almost all are detabs. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@659902 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/env.xml b/docs/manual/env.xml index 07321a21c99..5fc3fb03ff0 100644 --- a/docs/manual/env.xml +++ b/docs/manual/env.xml @@ -459,9 +459,9 @@ SetEnvIf Referer "^$" local_referal </Directory>

For more information about this technique, see the - "Keeping Your Images from Adorning Other Sites" - tutorial on ServerWatch.

+ "Keeping Your Images from Adorning Other Sites" + tutorial on ServerWatch.

diff --git a/docs/manual/filter.xml b/docs/manual/filter.xml index 970c0400870..9c35c0c6bae 100644 --- a/docs/manual/filter.xml +++ b/docs/manual/filter.xml @@ -32,11 +32,11 @@ Filtering in Apache 2 - mod_filter + mod_filter mod_deflate mod_ext_filter mod_include - mod_charset_lite + mod_charset_lite FilterChain diff --git a/docs/manual/howto/public_html.xml b/docs/manual/howto/public_html.xml index 6665d61b69d..3efce8a8e01 100644 --- a/docs/manual/howto/public_html.xml +++ b/docs/manual/howto/public_html.xml @@ -37,7 +37,7 @@ enabled. You can enable access when using UserDir by uncommenting the line

- #Include conf/extra/httpd-userdir.conf + #Include conf/extra/httpd-userdir.conf

in the default config file, and adapting the httpd-userdir.conf diff --git a/docs/manual/howto/ssi.xml b/docs/manual/howto/ssi.xml index 0d81976ce51..9bdb21c7171 100644 --- a/docs/manual/howto/ssi.xml +++ b/docs/manual/howto/ssi.xml @@ -100,7 +100,7 @@ existing HTML documents.

the following directives:

AddType text/html .shtml
- AddOutputFilter INCLUDES .shtml + AddOutputFilter INCLUDES .shtml

One disadvantage to this approach is that if you wanted to diff --git a/docs/manual/logs.xml b/docs/manual/logs.xml index ed88ab7fd92..591baa9773e 100644 --- a/docs/manual/logs.xml +++ b/docs/manual/logs.xml @@ -163,8 +163,8 @@ directives to control access logging, including mod_log_referer, mod_log_agent, and the TransferLog directive. The CustomLog directive now subsumes - the functionality of all the older directives.

+ module="mod_log_config">CustomLog directive now subsumes + the functionality of all the older directives.

The format of the access log is highly configurable. The format is specified using a format string that looks much like a C-style @@ -196,11 +196,11 @@ control characters "\n" for new-line and "\t" for tab.

-

The CustomLog - directive sets up a new log file using the defined - nickname. The filename for the access log is relative to - the ServerRoot unless it - begins with a slash.

+

The CustomLog + directive sets up a new log file using the defined + nickname. The filename for the access log is relative to + the ServerRoot unless it + begins with a slash.

The above configuration will write log entries in a format known as the Common Log Format (CLF). This standard format can @@ -374,7 +374,7 @@ information. The last two CustomLog lines show how to mimic the effects of the ReferLog and AgentLog directives.

+ >AgentLog directives.

LogFormat "%h %l %u %t \"%r\" %>s %b" common
@@ -385,9 +385,9 @@

This example also shows that it is not necessary to define a nickname with the LogFormat directive. Instead, + module="mod_log_config">LogFormat directive. Instead, the log format can be specified directly in the CustomLog directive.

+ module="mod_log_config">CustomLog directive.

@@ -401,9 +401,9 @@ meets certain conditions. This is usually accomplished with SetEnvIf. Then the env= clause of the CustomLog directive is used to - include or exclude requests where the environment variable is - set. Some examples:

+ module="mod_log_config">CustomLog directive is used to + include or exclude requests where the environment variable is + set. Some examples:

# Mark requests from the loop-back interface
@@ -609,7 +609,7 @@

On startup, Apache httpd saves the process id of the parent httpd process to the file logs/httpd.pid. This filename can be changed with the PidFile directive. The + module="mpm_common">PidFile directive. The process-id is for use by the administrator in restarting and terminating the daemon by sending signals to the parent process; on Windows, use the -k command line option instead. diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml index ac191af6e28..1443bb8f8fc 100644 --- a/docs/manual/mod/core.xml +++ b/docs/manual/mod/core.xml @@ -2628,7 +2628,7 @@ to name-virtual hosts

The ServerAlias directive sets the alternate names for a host, for use with name-based virtual hosts. The + href="../vhosts/name-based.html">name-based virtual hosts. The ServerAlias may include wildcards, if appropriate.

diff --git a/docs/manual/mod/mod_auth_digest.xml b/docs/manual/mod/mod_auth_digest.xml index 5ea71370c4e..f08743685b3 100644 --- a/docs/manual/mod/mod_auth_digest.xml +++ b/docs/manual/mod/mod_auth_digest.xml @@ -61,8 +61,8 @@ AuthType Digest
AuthName "private area"
AuthDigestDomain /private/ http://mirror.my.dom/private2/
-
- AuthDigestProvider file
+
+ AuthDigestProvider file
AuthUserFile /web/auth/.digest_pw
Require valid-user
diff --git a/docs/manual/mod/mod_authn_anon.xml b/docs/manual/mod/mod_authn_anon.xml index 4aeb14a6277..4f26560bfa8 100644 --- a/docs/manual/mod/mod_authn_anon.xml +++ b/docs/manual/mod/mod_authn_anon.xml @@ -87,7 +87,7 @@ AuthType Basic
AuthBasicProvider file anon
AuthUserFile /path/to/your/.htpasswd
-
+
Anonymous_NoUserID off
Anonymous_MustGiveEmail on
Anonymous_VerifyEmail on
diff --git a/docs/manual/mod/mod_dav.xml b/docs/manual/mod/mod_dav.xml index 4e377f22dc9..9894f4e0c32 100644 --- a/docs/manual/mod/mod_dav.xml +++ b/docs/manual/mod/mod_dav.xml @@ -79,23 +79,23 @@ Full Example DavLockDB /usr/local/apache2/var/DavLock

- <Directory /usr/local/apache2/htdocs/foo>
- - Order Allow,Deny
- Allow from all
- Dav On
-
- AuthType Basic
- AuthName DAV
- AuthUserFile user.passwd
-
- <LimitExcept GET POST OPTIONS>
- - Require user admin
- - </LimitExcept>
- - </Directory>
+ <Directory /usr/local/apache2/htdocs/foo>
+ + Order Allow,Deny
+ Allow from all
+ Dav On
+
+ AuthType Basic
+ AuthName DAV
+ AuthUserFile user.passwd
+
+ <LimitExcept GET POST OPTIONS>
+ + Require user admin
+ + </LimitExcept>
+ + </Directory>

mod_dav is a descendent of Greg Stein's MimeMagicFile Content-Language: en, fr
- Content-Type: text/plain; charset=ISO-8859-1 + Content-Type: text/plain; charset=ISO-8859-1

The language specification is the two-letter abbreviation diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml index 05439f59a21..cbdebabac04 100644 --- a/docs/manual/mod/mod_proxy.xml +++ b/docs/manual/mod/mod_proxy.xml @@ -517,11 +517,11 @@ expressions BalancerMember Add a member to a load balancing group BalancerMember url [key=value [key=value ...]] + >key=value [key=value ...]] directory BalancerMember is only available in Apache 2.2 - and later. + and later.

This directive adds a member to a load balancing group. It must be used within a <Proxy balancer://...> container @@ -542,7 +542,7 @@ expressions directory ProxySet is only available in Apache 2.2 - and later. + and later.

This directive is used as an alternate method of setting any of the parameters available to Proxy balancers and workers normally done via the @@ -593,7 +593,7 @@ expressions ProxyPass Maps remote servers into the local server URL-space ProxyPass [path] !|url [key=value - [key=value ...]] [nocanon] [interpolate] + [key=value ...]] [nocanon] [interpolate] server configvirtual host directory @@ -776,8 +776,8 @@ expressions - Single letter value defining the initial status of this worker: 'D' is disabled, 'S' is stopped, 'I' is ignore-errors, - 'H' is hot-standby and 'E' is in an error state. Status - can be set (which is the default) by prepending with '+' or + 'H' is hot-standby and 'E' is in an error state. Status + can be set (which is the default) by prepending with '+' or cleared by prepending with '-'. Thus, a setting of 'S-E' sets this worker to Stopped and clears the in-error flag. @@ -1277,7 +1277,7 @@ directly

A Hostname is a fully qualified DNS domain name which can be resolved to one or more IPAddrs via the DNS domain name service. It represents a logical host (in contrast to - Domains, see above) and must be resolvable + Domains, see above) and must be resolvable to at least one IPAddr (or often to a list of hosts with different IPAddrs).

diff --git a/docs/manual/mod/mod_proxy_balancer.xml b/docs/manual/mod/mod_proxy_balancer.xml index cec901779c2..d706de1c53a 100644 --- a/docs/manual/mod/mod_proxy_balancer.xml +++ b/docs/manual/mod/mod_proxy_balancer.xml @@ -59,19 +59,19 @@
- Example of a balancer configuration -

Before we dive into the technical details, here's an example of - how you might use mod_proxy_balancer to provide - load balancing between two back-end servers: -

- - - <Proxy balancer://mycluster>
- BalancerMember http://192.168.1.50:80
- BalancerMember http://192.168.1.51:80
- </Proxy>
- ProxyPass /test balancer://mycluster/ - + Example of a balancer configuration +

Before we dive into the technical details, here's an example of + how you might use mod_proxy_balancer to provide + load balancing between two back-end servers: +

+ + + <Proxy balancer://mycluster>
+ BalancerMember http://192.168.1.50:80
+ BalancerMember http://192.168.1.51:80
+ </Proxy>
+ ProxyPass /test balancer://mycluster/ +
diff --git a/docs/manual/mod/mod_proxy_ftp.xml b/docs/manual/mod/mod_proxy_ftp.xml index 5005ce7ecf3..49b04966b50 100644 --- a/docs/manual/mod/mod_proxy_ftp.xml +++ b/docs/manual/mod/mod_proxy_ftp.xml @@ -57,7 +57,7 @@ 
application/octet-stream   bin dms lha lzh exe class tgz taz
 -

Alternatively you may prefer to default everything to binary:

+

Alternatively you may prefer to default everything to binary:

DefaultType application/octet-stream
 @@ -74,8 +74,8 @@
How can I do FTP upload? -

Currently, only GET is supported for FTP in mod_proxy. You can - of course use HTTP upload (POST or PUT) through an Apache proxy.

+

Currently, only GET is supported for FTP in mod_proxy. You can + of course use HTTP upload (POST or PUT) through an Apache proxy.

How can I access FTP files outside diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml index a5a80344281..c995ab82f25 100644 --- a/docs/manual/mod/mod_rewrite.xml +++ b/docs/manual/mod/mod_rewrite.xml @@ -487,16 +487,16 @@ while (<STDIN>) { <ol> <li>``<em>Keep it simple, stupid</em>'' (KISS). - If this program hangs, it will cause Apache to hang - when trying to use the relevant rewrite rule.</li> + If this program hangs, it will cause Apache to hang + when trying to use the relevant rewrite rule.</li> <li>A common mistake is to use buffered I/O on <code>stdout</code>. Avoid this, as it will cause a deadloop! ``<code>$|=1</code>'' is used above, to prevent this.</li> <li>The <directive - module="mod_rewrite">RewriteLock</directive> directive can - be used to define a lockfile which mod_rewrite can use to synchronize + module="mod_rewrite">RewriteLock</directive> directive can + be used to define a lockfile which mod_rewrite can use to synchronize communication with the mapping program. By default no such synchronization takes place.</li> </ol> @@ -625,8 +625,8 @@ Result: has to be re-injected into the Apache kernel. This is not the serious overhead it may seem to be - this re-injection is completely internal to the - Apache server (and the same procedure is used by - many other operations within Apache).</p> + Apache server (and the same procedure is used by + many other operations within Apache).</p> </note> </usage> @@ -661,7 +661,7 @@ Result: (0 <= N <= 9), which provide access to the grouped parts (in parentheses) of the pattern, from the <code>RewriteRule</code> which is subject to the current - set of <code>RewriteCond</code> conditions.. + set of <code>RewriteCond</code> conditions.. </li> <li> <strong>RewriteCond backreferences</strong>: These are @@ -674,7 +674,7 @@ Result: <li> <strong>RewriteMap expansions</strong>: These are expansions of the form <strong><code - >${mapname:key|default}</code></strong>. + >${mapname:key|default}</code></strong>. See <a href="#mapfunc">the documentation for RewriteMap</a> for more details. </li> @@ -691,11 +691,11 @@ Result: <column width=".3"/></columnspec> <tr> <th>HTTP headers:</th> <th>connection & request:</th> <th></th> - </tr> + </tr> <tr> - <td> - HTTP_USER_AGENT<br /> + <td> + HTTP_USER_AGENT<br /> HTTP_REFERER<br /> HTTP_COOKIE<br /> HTTP_FORWARDED<br /> @@ -716,17 +716,17 @@ Result: QUERY_STRING<br /> AUTH_TYPE<br /> </td> - - <td></td> + + <td></td> </tr> <tr> <th>server internals:</th> <th>date and time:</th> <th>specials:</th> - </tr> + </tr> <tr> - <td> - DOCUMENT_ROOT<br /> + <td> + DOCUMENT_ROOT<br /> SERVER_ADMIN<br /> SERVER_NAME<br /> SERVER_ADDR<br /> @@ -764,7 +764,7 @@ Result: Most are documented elsewhere in the Manual or in the CGI specification. Those that are special to mod_rewrite include those below.</p> - <note> + <note> <dl> <dt><code>IS_SUBREQ</code></dt> @@ -830,8 +830,8 @@ Result: <li> <code>%{ENV:variable}</code>, where <em>variable</em> can be - any environment variable, is also available. - This is looked-up via internal + any environment variable, is also available. + This is looked-up via internal Apache structures and (if not found there) via <code>getenv()</code> from the Apache server process.</li> @@ -846,8 +846,8 @@ Result: <li> <code>%{HTTP:header}</code>, where <em>header</em> can be - any HTTP MIME-header name, can always be used to obtain the - value of a header sent in the HTTP request. + any HTTP MIME-header name, can always be used to obtain the + value of a header sent in the HTTP request. Example: <code>%{HTTP:Proxy-Connection}</code> is the value of the HTTP header ``<code>Proxy-Connection:</code>''. @@ -863,21 +863,21 @@ Result: <li> <code>%{LA-U:variable}</code> can be used for look-aheads which perform an internal (URL-based) sub-request to determine the final - value of <em>variable</em>. This can be used to access + value of <em>variable</em>. This can be used to access variable for rewriting which is not available at the current - stage, but will be set in a later phase. - <p>For instance, to rewrite according to the + stage, but will be set in a later phase. + <p>For instance, to rewrite according to the <code>REMOTE_USER</code> variable from within the per-server context (<code>httpd.conf</code> file) you must use <code>%{LA-U:REMOTE_USER}</code> - this variable is set by the authorization phases, which come - <em>after</em> the URL translation phase (during which mod_rewrite - operates).</p> - <p>On the other hand, because mod_rewrite implements + <em>after</em> the URL translation phase (during which mod_rewrite + operates).</p> + <p>On the other hand, because mod_rewrite implements its per-directory context (<code>.htaccess</code> file) via the Fixup phase of the API and because the authorization phases come <em>before</em> this phase, you just can use - <code>%{REMOTE_USER}</code> in that context.</p></li> + <code>%{REMOTE_USER}</code> in that context.</p></li> <li> <code>%{LA-F:variable}</code> can be used to perform an internal @@ -908,7 +908,7 @@ Result: <ul> <li>'<strong><CondPattern</strong>' (lexicographically - precedes)<br /> + precedes)<br /> Treats the <em>CondPattern</em> as a plain string and compares it lexicographically to <em>TestString</em>. True if <em>TestString</em> lexicographically precedes @@ -955,9 +955,9 @@ Result: <li>'<strong>-x</strong>' (has e<strong>x</strong>ecutable permissions)<br /> Treats the <em>TestString</em> as a pathname and tests - whether or not it exists, and has executable permissions. - These permissions are determined according to - the underlying OS.</li> + whether or not it exists, and has executable permissions. + These permissions are determined according to + the underlying OS.</li> <li>'<strong>-F</strong>' (is existing file, via subrequest)<br /> @@ -983,7 +983,7 @@ Result: </note> </li> - <li>You can also set special flags for + <li>You can also set special flags for <em>CondPattern</em> by appending <strong><code>[</code><em>flags</em><code>]</code></strong> as the third argument to the <code>RewriteCond</code> @@ -994,7 +994,7 @@ Result: <li>'<strong><code>nocase|NC</code></strong>' (<strong>n</strong>o <strong>c</strong>ase)<br /> This makes the test case-insensitive - differences - between 'A-Z' and 'a-z' are ignored, both in the + between 'A-Z' and 'a-z' are ignored, both in the expanded <em>TestString</em> and the <em>CondPattern</em>. This flag is effective only for comparisons between <em>TestString</em> and <em>CondPattern</em>. It has no @@ -1051,14 +1051,14 @@ RewriteRule ^/$ /homepage.std.html [L] </example> <p>Explanation: If you use a browser which identifies itself - as 'Mozilla' (including Netscape Navigator, Mozilla etc), then you + as 'Mozilla' (including Netscape Navigator, Mozilla etc), then you get the max homepage (which could include frames, or other special - features). + features). If you use the Lynx browser (which is terminal-based), then - you get the min homepage (which could be a version designed for - easy, text-only browsing). - If neither of these conditions apply (you use any other browser, - or your browser identifies itself as something non-standard), you get + you get the min homepage (which could be a version designed for + easy, text-only browsing). + If neither of these conditions apply (you use any other browser, + or your browser identifies itself as something non-standard), you get the std (standard) homepage.</p> </usage> @@ -1102,8 +1102,8 @@ RewriteRule ^/$ /homepage.std.html [L] the <a href="../rewrite/rewrite_intro.html#regex">mod_rewrite Introduction</a>.</p> - <p>In mod_rewrite, the NOT character - ('<code>!</code>') is also available as a possible pattern + <p>In mod_rewrite, the NOT character + ('<code>!</code>') is also available as a possible pattern prefix. This enables you to negate a pattern; to say, for instance: ``<em>if the current URL does <strong>NOT</strong> match this pattern</em>''. This can be used for exceptional cases, where @@ -1184,7 +1184,7 @@ cannot use <code>$N</code> in the substitution string! </ol> <p>Back-references are identifiers of the form - <code>$</code><strong>N</strong> + <code>$</code><strong>N</strong> (<strong>N</strong>=0..9), which will be replaced by the contents of the <strong>N</strong>th group of the matched <em>Pattern</em>. The server-variables are the same @@ -1273,17 +1273,17 @@ cannot use <code>$N</code> in the substitution string! <code>%N</code>) which will be expanded. You can use this flag more than once, to set more than one variable. The variables can later be dereferenced in many situations, most commonly - from within XSSI (via <code><!--#echo + from within XSSI (via <code><!--#echo var="VAR"--></code>) or CGI (<code>$ENV{'VAR'}</code>). - You can also dereference the variable in a later RewriteCond pattern, using + You can also dereference the variable in a later RewriteCond pattern, using <code>%{ENV:VAR}</code>. Use this to strip information from URLs, while maintaining a record of that information.</dd> <dt>'<code>forbidden|F</code>' (force URL to be forbidden)</dt><dd> This forces the current URL to be forbidden - it immediately - sends back a HTTP response of 403 (FORBIDDEN). - Use this flag in conjunction with + sends back a HTTP response of 403 (FORBIDDEN). + Use this flag in conjunction with appropriate RewriteConds to conditionally block some URLs.</dd> @@ -1299,8 +1299,8 @@ cannot use <code>$N</code> in the substitution string! Force the Content-handler of the target file to be <em>Content-handler</em>. For instance, this can be used to simulate the <module>mod_alias</module> directive - <directive module="mod_alias">ScriptAlias</directive>, - which internally forces all files + <directive module="mod_alias">ScriptAlias</directive>, + which internally forces all files inside the mapped directory to have a handler of ``<code>cgi-script</code>''.</dd> @@ -1369,7 +1369,7 @@ cannot use <code>$N</code> in the substitution string! exclude some rules.</p> <p>To decide whether or not to use this rule: if you prefix URLs with CGI-scripts, to force them to be - processed by the CGI-script, it's likely that you + processed by the CGI-script, it's likely that you will run into problems (or significant overhead) on sub-requests. In these cases, use this flag.</p> </dd> @@ -1378,8 +1378,8 @@ cannot use <code>$N</code> in the substitution string! '<code>proxy|P</code>' (force proxy)</dt><dd> This flag forces the substitution part to be internally - sent as a proxy request and immediately (rewrite - processing stops here) put through the <a + sent as a proxy request and immediately (rewrite + processing stops here) put through the <a href="mod_proxy.html">proxy module</a>. You must make sure that the substitution string is a valid URI (typically starting with @@ -1418,7 +1418,7 @@ cannot use <code>$N</code> in the substitution string! </example> If you omit the <code>PT</code> flag, <code>mod_rewrite</code> will rewrite - <code>uri=/abc/...</code> to + <code>uri=/abc/...</code> to <code>filename=/def/...</code> as a full API-compliant URI-to-filename translator should do. Then <code>mod_alias</code> will try to do a diff --git a/docs/manual/mod/mod_usertrack.xml b/docs/manual/mod/mod_usertrack.xml index bc6bfc18090..093a168971b 100644 --- a/docs/manual/mod/mod_usertrack.xml +++ b/docs/manual/mod/mod_usertrack.xml @@ -136,7 +136,6 @@ time late in the year "37". should still use your actual domain, as you would with any other top level domain (for example <code>.foo.co.uk</code>). </note> - </usage> </directivesynopsis> diff --git a/docs/manual/new_features_2_2.xml b/docs/manual/new_features_2_2.xml index 875189e77ab..c5cd76fd9ef 100644 --- a/docs/manual/new_features_2_2.xml +++ b/docs/manual/new_features_2_2.xml @@ -90,7 +90,6 @@ ordering problems in the 2.0 architecture.</dd> <dt>Large File Support</dt> - <dd>httpd is now built with support for files larger than 2GB on modern 32-bit Unix systems. Support for handling >2GB request bodies has also been added.</dd> @@ -103,10 +102,9 @@ timeout was reached.</dd> <dt>SQL Database Support</dt> - <dd><p><module>mod_dbd</module>, together with the apr_dbd framework, + <dd><module>mod_dbd</module>, together with the apr_dbd framework, brings direct SQL support to modules that need it. Supports - connection pooling in threaded MPMs.</p> - </dd> + connection pooling in threaded MPMs.</dd> </dl> </section> diff --git a/docs/manual/programs/rotatelogs.xml b/docs/manual/programs/rotatelogs.xml index 25f855edf76..68214dff0ef 100644 --- a/docs/manual/programs/rotatelogs.xml +++ b/docs/manual/programs/rotatelogs.xml @@ -103,7 +103,7 @@ an offset.</dd> <example> CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common </example> - + <p>This creates the files /var/logs/logfile.nnnn where nnnn is the system time at which the log nominally starts (this time will always be a multiple of the rotation time, so you can @@ -113,7 +113,7 @@ an offset.</dd> <example> CustomLog "|bin/rotatelogs -l /var/logs/logfile.%Y.%m.%d 86400" common </example> - + <p>This creates the files /var/logs/logfile.yyyy.mm.dd where yyyy is the year, mm is the month, and dd is the day of the month. Logging will switch to a new file every day at midnight, local time.</p> diff --git a/docs/manual/ssl/ssl_faq.xml b/docs/manual/ssl/ssl_faq.xml index 64d18891d3c..14ed06cb957 100644 --- a/docs/manual/ssl/ssl_faq.xml +++ b/docs/manual/ssl/ssl_faq.xml @@ -111,7 +111,7 @@ generate temporary 512 bit RSA private key" when I start Apache?</a></li> </ul> <section id="mutex"><title>Why do I get permission errors related to - SSLMutex when I start Apache? + SSLMutex when I start Apache?

Errors such as ``mod_ssl: Child could not open SSLMutex lockfile /opt/apache/logs/ssl_mutex.18332 (System error follows) [...] System: Permission denied (errno: 13)'' are usually @@ -123,8 +123,8 @@ generate temporary 512 bit RSA private key" when I start Apache?

Why does mod_ssl stop with the error - "Failed to generate temporary 512 bit RSA private key" when I start - Apache? + "Failed to generate temporary 512 bit RSA private key" when I start + Apache?

Cryptographic software needs a source of unpredictable data to work correctly. Many open source operating systems provide a "randomness device" that serves this purpose (usually named @@ -160,7 +160,7 @@ relative hyperlinks?

Is it possible to provide HTTP and HTTPS - from the same server? + from the same server?

Yes. HTTP and HTTPS use different server ports (HTTP binds to port 80, HTTPS to port 443), so there is no direct conflict between them. You can either run two separate server instances bound to @@ -327,24 +327,24 @@ Certificate for testing purposes?

  • Run the following command, to create server.key and server.crt files:
    - $ openssl req -new -x509 -nodes -out server.crt - -keyout server.key
    - These can be used as follows in your httpd.conf - file: + $ openssl req -new -x509 -nodes -out server.crt + -keyout server.key
    + These can be used as follows in your httpd.conf + file: 
                  SSLCertificateFile    /path/to/this/server.crt
              SSLCertificateKeyFile /path/to/this/server.key
-
    +
  • It is important that you are aware that this - server.key does not have any passphrase. - To add a passphrase to the key, you should run the following - command, and enter & verify the passphrase as requested.
    -

    $ openssl rsa -des3 -in server.key -out - server.key.new
    - $ mv server.key.new server.key

    - Please backup the server.key file, and the passphrase - you entered, in a secure location. + server.key does not have any passphrase. + To add a passphrase to the key, you should run the following + command, and enter & verify the passphrase as requested.
    +

    $ openssl rsa -des3 -in server.key -out + server.key.new
    + $ mv server.key.new server.key

    + Please backup the server.key file, and the passphrase + you entered, in a secure location.
    • @@ -481,7 +481,7 @@ Certificate for testing purposes? with the RSA key you just created (output will be PEM formatted):

    $ openssl req -new -x509 -nodes -sha1 -days 365 - -key server.key -out server.crt
    + -key server.key -out server.crt

    This signs the server CSR and results in a server.crt file.
    You can see the details of this Certificate using:
    @@ -924,16 +924,16 @@ for my core dump?
    Answers in the User Manual's F.A.Q. List (this)
    - http://httpd.apache.org/docs/&httpd.docs;/ssl/ssl_faq.html
    - First check the F.A.Q. (this text). If your problem is a common - one, it may have been answered several times before, and been included - in this doc. + http://httpd.apache.org/docs/&httpd.docs;/ssl/ssl_faq.html
    + First check the F.A.Q. (this text). If your problem is a common + one, it may have been answered several times before, and been included + in this doc.
    Postings from the modssl-users Support Mailing List http://www.modssl.org/support/
    Search for your problem in the archives of the modssl-users mailing list. - You're probably not the first person to have had this problem! + You're probably not the first person to have had this problem!
    @@ -941,16 +941,16 @@ for my core dump?
    What support contacts are available in case of mod_ssl problems?

    The following lists all support possibilities for mod_ssl, in order of - preference. Please go through these possibilities - in this order - don't just pick the one you like the look of.

    + preference. Please go through these possibilities + in this order - don't just pick the one you like the look of.

    1. Send a Problem Report to the modssl-users Support Mailing List
      modssl-users@modssl.org
      This is the preferred way of submitting your problem report, because this way, - others can see the problem, and learn from any answers. You must subscribe to + others can see the problem, and learn from any answers. You must subscribe to the list first, but you can then easily discuss your problem with both the - author and the whole mod_ssl user community. + author and the whole mod_ssl user community.
    2. Send a Problem Report to the Apache httpd Users Support Mailing List
      @@ -962,11 +962,11 @@ of mod_ssl problems?
    3. Write a Problem Report in the Bug Database
      - - http://httpd.apache.org/bug_report.html
      + + http://httpd.apache.org/bug_report.html
      This is the last way of submitting your problem report. You should only - do this if you've already posted to the mailing lists, and had no success. - Please follow the instructions on the above page carefully. + do this if you've already posted to the mailing lists, and had no success. + Please follow the instructions on the above page carefully.
    @@ -1029,8 +1029,8 @@ the reason for my core dump?
  • Start the server and try to reproduce the core-dump. For this you may want to use a directive like ``CoreDumpDirectory /tmp'' to - make sure that the core-dump file can be written. This should result - in a /tmp/core or /tmp/httpd.core file. If you + make sure that the core-dump file can be written. This should result + in a /tmp/core or /tmp/httpd.core file. If you don't get one of these, try running your server under a non-root UID. Many modern kernels do not allow a process to dump core after it has done a setuid() (unless it does an exec()) for @@ -1041,7 +1041,7 @@ the reason for my core dump?
  • Analyze the core-dump. For this, run gdb /path/to/httpd /tmp/httpd.core or a similar command. In GDB, all you - have to do then is to enter bt, and voila, you get the + have to do then is to enter bt, and voila, you get the backtrace. For other debuggers consult your local debugger manual.
    • diff --git a/docs/manual/ssl/ssl_howto.xml b/docs/manual/ssl/ssl_howto.xml index 87c9a0235a5..df90aa08d4c 100644 --- a/docs/manual/ssl/ssl_howto.xml +++ b/docs/manual/ssl/ssl_howto.xml @@ -159,10 +159,11 @@ Intranet website, for clients coming from the Internet?
    How can I force clients to authenticate using certificates for a - particular URL, but still allow arbitrary clients to access the rest of the server? + particular URL, but still allow arbitrary clients to access the rest of the server? -

    To force clients to authenticate using certificates for a particular URL, - you can use the per-directory reconfiguration features of mod_ssl:

    +

    To force clients to authenticate using certificates for a particular URL, + you can use the per-directory reconfiguration features of + mod_ssl:

    httpd.conf SSLVerifyClient none
    @@ -177,7 +178,7 @@ Intranet website, for clients coming from the Internet?
    How can I allow only clients who have certificates to access a - particular URL, but allow all clients to access the rest of the server? + particular URL, but allow all clients to access the rest of the server?

    The key to doing this is checking that part of the client certificate matches what you expect. Usually this means checking all or part of the diff --git a/docs/manual/ssl/ssl_intro.xml b/docs/manual/ssl/ssl_intro.xml index ec1f4933656..554cf22ec3a 100644 --- a/docs/manual/ssl/ssl_intro.xml +++ b/docs/manual/ssl/ssl_intro.xml @@ -356,7 +356,7 @@ dUHzICxBVC1lnHyYGjDuAMhe396lYAn8bCld1/L4NMGBCQ== they also manage them -- that is, they determine for how long certificates remain valid, they renew them, and they keep lists of certificates that were issued in the past but are no longer valid - (Certificate Revocation Lists, or CRLs).

    + (Certificate Revocation Lists, or CRLs).

    For example, if Alice is entitled to a certificate as an employee of a company, but has now left diff --git a/docs/manual/style/lang/pt-br.xml b/docs/manual/style/lang/pt-br.xml index 93b0c206431..9ee1395e91a 100644 --- a/docs/manual/style/lang/pt-br.xml +++ b/docs/manual/style/lang/pt-br.xml @@ -129,7 +129,7 @@ Glossário Mapa do site - + Licenciado sob a Línguas Disponíveis diff --git a/docs/manual/vhosts/examples.xml b/docs/manual/vhosts/examples.xml index 99a685fb534..4e1b366d177 100644 --- a/docs/manual/vhosts/examples.xml +++ b/docs/manual/vhosts/examples.xml @@ -101,9 +101,9 @@ NameVirtualHost 172.20.30.40
    -
    +
    <VirtualHost 172.20.30.40>
    - # etc ... + # etc ...

    However, it is additionally useful to use * @@ -120,15 +120,15 @@ configuration will not work for, in fact, is when you are serving different content based on differing IP addresses or ports.

    -
    +
    -
    Name-based hosts on more than one + <section id="twoips"><title>Name-based hosts on more than one IP address. - - Note

    Any of the - techniques discussed here can be extended to any number of IP - addresses.

    + + Note +

    Any of the techniques discussed here can be extended to any + number of IP addresses.

    The server has two IP addresses. On one (172.20.30.40), we @@ -139,31 +139,31 @@ Server configuration Listen 80
    -
    +
    # This is the "main" server running on 172.20.30.40
    ServerName server.domain.com
    DocumentRoot /www/mainserver
    -
    +
    # This is the other address
    NameVirtualHost 172.20.30.50
    -
    +
    <VirtualHost 172.20.30.50>
    DocumentRoot /www/example1
    ServerName www.example.com
    -
    +
    # Other directives here ...
    -
    +
    </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.50>
    DocumentRoot /www/example2
    ServerName www.example.org
    -
    +
    # Other directives here ...
    -
    +
    </VirtualHost> @@ -173,9 +173,9 @@ unknown hostname, or no Host: header, will be served from www.example.com.

    -
    + -
    Serving the same content on + <section id="intraextra"><title>Serving the same content on different IP addresses (such as an internal and external address). @@ -196,7 +196,7 @@ NameVirtualHost 192.168.1.1
    NameVirtualHost 172.20.30.40
    -
    +
    <VirtualHost 192.168.1.1 172.20.30.40>
    DocumentRoot /www/server1
    @@ -220,9 +220,9 @@ respond the same on all addresses.

    -
    + -
    Running different sites on different + <section id="port"><title>Running different sites on different ports.

    You have multiple domains going to the same IP and also want to @@ -236,31 +236,31 @@ Listen 80
    Listen 8080
    -
    +
    NameVirtualHost 172.20.30.40:80
    NameVirtualHost 172.20.30.40:8080
    -
    +
    <VirtualHost 172.20.30.40:80>
    ServerName www.example.com
    DocumentRoot /www/domain-80
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40:8080>
    ServerName www.example.com
    DocumentRoot /www/domain-8080
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40:80>
    ServerName www.example.org
    DocumentRoot /www/otherdomain-80
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40:8080>
    ServerName www.example.org
    @@ -269,9 +269,9 @@ </VirtualHost> -

    + -
    IP-based virtual hosting +
    IP-based virtual hosting

    The server has two IP addresses (172.20.30.40 and 172.20.30.50) which resolve to the names @@ -282,14 +282,14 @@ Server configuration Listen 80
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/example1
    ServerName www.example.com
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.50>
    DocumentRoot /www/example2
    @@ -303,10 +303,10 @@ localhost, for example) will go to the main server, if there is one.

    -
    +
    -
    Mixed port-based and ip-based virtual - hosts +
    Mixed port-based and ip-based virtual + hosts

    The server machine has two IP addresses (172.20.30.40 and 172.20.30.50) which resolve to the names @@ -321,28 +321,28 @@ Listen 172.20.30.40:8080
    Listen 172.20.30.50:80
    Listen 172.20.30.50:8080
    -
    +
    <VirtualHost 172.20.30.40:80>
    DocumentRoot /www/example1-80
    ServerName www.example.com
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40:8080>
    DocumentRoot /www/example1-8080
    ServerName www.example.com
    -     + </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.50:80>
    DocumentRoot /www/example2-80
    ServerName www.example.org
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.50:8080>
    DocumentRoot /www/example2-8080
    @@ -351,9 +351,9 @@ </VirtualHost> -

    +
    -
    Mixed name-based and IP-based + <section id="mixed"><title>Mixed name-based and IP-based vhosts

    On some of my addresses, I want to do name-based virtual hosts, and @@ -363,30 +363,30 @@ Server configuration Listen 80
    -
    +
    NameVirtualHost 172.20.30.40
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/example1
    ServerName www.example.com
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/example2
    ServerName www.example.org
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/example3
    ServerName www.example3.net
     </VirtualHost>
    -
    +
    # IP-based
    <VirtualHost 172.20.30.50>
    @@ -394,7 +394,7 @@ ServerName www.example4.edu
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.60>
    DocumentRoot /www/example5
    @@ -403,7 +403,7 @@ </VirtualHost> -

    +
    Using <code>Virtual_host</code> and mod_proxy together @@ -427,10 +427,10 @@
    -
    Using <code>_default_</code> + <section id="default"><title>Using <code>_default_</code> vhosts -
    <code>_default_</code> vhosts + <section id="defaultallports"><title><code>_default_</code> vhosts for all ports

    Catching every request to any unspecified IP address and @@ -476,7 +476,7 @@ # ...
    </VirtualHost>
    -
    +
    <VirtualHost _default_:*>
    DocumentRoot /www/default
    @@ -511,9 +511,9 @@ served from the main server.

    -
    + -
    Migrating a name-based vhost to an + <section id="migrate"><title>Migrating a name-based vhost to an IP-based vhost

    The name-based vhost with the hostname @@ -534,9 +534,9 @@ Listen 80
    ServerName www.example.com
    DocumentRoot /www/example1
    -
    +
    NameVirtualHost 172.20.30.40
    -
    +
    <VirtualHost 172.20.30.40 172.20.30.50>
    DocumentRoot /www/example2
    @@ -544,7 +544,7 @@ # ...
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/example3
    @@ -559,10 +559,10 @@ IP-based vhost) and through the old address (as a name-based vhost).

    -
    + -
    Using the <code>ServerPath</code> - directive +
    Using the <code>ServerPath</code> + directive

    We have a server with two name-based vhosts. In order to match the correct virtual host a client must send the correct Host: @@ -577,7 +577,7 @@ Server configuration NameVirtualHost 172.20.30.40
    -
    +
    <VirtualHost 172.20.30.40>
    # primary vhost
    @@ -587,7 +587,7 @@ # ...
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/subdomain/sub1
    @@ -598,7 +598,7 @@ # ...
     </VirtualHost>
    -
    +
    <VirtualHost 172.20.30.40>
    DocumentRoot /www/subdomain/sub2
    @@ -629,6 +629,6 @@ Host: header can use both URL variants, i.e., with or without URL prefix.

    -
    +
    diff --git a/docs/manual/vhosts/fd-limits.xml b/docs/manual/vhosts/fd-limits.xml index 1bb819ba047..a0f2f341b99 100644 --- a/docs/manual/vhosts/fd-limits.xml +++ b/docs/manual/vhosts/fd-limits.xml @@ -54,7 +54,7 @@ below 256. (Solaris 2) -

    In the event of problems you can:

    +

    In the event of problems you can:

    • Reduce the number of log files; don't specify log files diff --git a/docs/manual/vhosts/ip-based.xml b/docs/manual/vhosts/ip-based.xml index 45c7e0e9178..7b54a12b490 100644 --- a/docs/manual/vhosts/ip-based.xml +++ b/docs/manual/vhosts/ip-based.xml @@ -102,7 +102,7 @@
      Setting up a single daemon - with virtual hosts + with virtual hosts

      For this case, a single httpd will service requests for the main server and all the virtual hosts. The TransferLog /groups/smallco/logs/access_log
      </VirtualHost>
      -
      +
      <VirtualHost www.baygroup.org>
      ServerAdmin webmaster@mail.baygroup.org
      DocumentRoot /groups/baygroup/www
      @@ -133,7 +133,7 @@ ErrorLog /groups/baygroup/logs/error_log
      TransferLog /groups/baygroup/logs/access_log
      </VirtualHost> - +

      It is recommended that you use an IP address instead of a hostname (see DNS caveats).

      diff --git a/docs/manual/vhosts/mass.xml b/docs/manual/vhosts/mass.xml index 2b820694d2c..c9b7f4a000e 100644 --- a/docs/manual/vhosts/mass.xml +++ b/docs/manual/vhosts/mass.xml @@ -189,7 +189,7 @@ ScriptAlias /cgi-bin/ /www/std-cgi/
      Using Multiple Virtual - Hosting Systems on the Same Server + Hosting Systems on the Same Server

      With more complicated setups, you can use Apache's normal <VirtualHost> directives to control the @@ -242,15 +242,15 @@ LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
      - Note -

      If the first VirtualHost block does not include a - ServerName directive, the reverse - DNS of the relevant IP will be used instead. - If this is not the server name you - wish to use, a bogus entry (ServerName - none.example.com) can be added to get around this - behaviour.

      - + Note +

      If the first VirtualHost block does not include a + ServerName directive, the reverse + DNS of the relevant IP will be used instead. + If this is not the server name you + wish to use, a bogus entry (ServerName + none.example.com) can be added to get around this + behaviour.

      +
      diff --git a/docs/manual/vhosts/name-based.xml b/docs/manual/vhosts/name-based.xml index ae5a432ae85..b6918a3bc52 100644 --- a/docs/manual/vhosts/name-based.xml +++ b/docs/manual/vhosts/name-based.xml @@ -79,12 +79,12 @@ - DocumentRoot - NameVirtualHost - ServerAlias - ServerName - ServerPath - VirtualHost + DocumentRoot + NameVirtualHost + ServerAlias + ServerName + ServerPath + VirtualHost @@ -101,7 +101,7 @@ automatically make the server listen to that IP address. See Setting which addresses and ports Apache uses for more details. In addition, any IP address specified here must be - associated with a network interface on the server.

      + associated with a network interface on the server.

      The next step is to create a VirtualHost block for @@ -109,7 +109,7 @@ VirtualHost directive must match a defined NameVirtualHost directive. (In this usual case, - this will be "*:80"). Inside each VirtualHost block, you will need at minimum a ServerName directive to designate which host is served and a DocumentRoot @@ -205,7 +205,7 @@ the main server will never be used when an IP address matches the NameVirtualHost directive. If you would like to have a special configuration for requests - that do not match any particular virtual host, simply put that configuration + that do not match any particular virtual host, simply put that configuration in a VirtualHost container and list it first in the configuration file.