You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by er...@apache.org on 2002/08/24 13:20:23 UTC
cvs commit: httpd-2.0/docs/manual logs.xml logs.html.en
erikabele 2002/08/24 04:20:23
Modified: docs/manual logs.xml logs.html.en
Log:
Fixed a lot of typos and link errors.
Revision Changes Path
1.3 +33 -31 httpd-2.0/docs/manual/logs.xml
Index: logs.xml
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/logs.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- logs.xml 31 Jul 2002 20:54:22 -0000 1.2
+++ logs.xml 24 Aug 2002 11:20:22 -0000 1.3
@@ -40,8 +40,8 @@
<related>
<directivelist>
- <directive module="mod_core">ErrorLog</directive>
- <directive module="mod_core">LogLevel</directive>
+ <directive module="core">ErrorLog</directive>
+ <directive module="core">LogLevel</directive>
</directivelist>
</related>
@@ -145,17 +145,17 @@
<p>Various versions of Apache httpd have used other modules and
directives to control access logging, including
mod_log_referer, mod_log_agent, and the
- <code>TransferLog</code> directive. The <code>CustomLog</code>
- directive now subsumes the functionality of all the older
- directives.</p>
+ <code>TransferLog</code> directive. The <directive
+ module="mod_log_config">CustomLog</directive> directive now subsumes
+ the functionality of all the older directives.</p>
<p>The format of the access log is highly configurable. The
- format is specified using a <directive module="mod_log_config">
- CustomLog</directive> that
+ format is specified using a <directive
+ module="mod_log_config">CustomLog</directive> that
looks much like a C-style printf(1) format string. Some
examples are presented in the next sections. For a complete
list of the possible contents of the format string, see the <a
- href="mod/mod_log_config.html">mod_log_config
+ href="mod/mod_log_config.html#formats">mod_log_config
documentation</a>.</p>
<section id="common">
@@ -181,11 +181,11 @@
control characters "<code>\n</code>" for new-line and
"<code>\t</code>" for tab.</p>
- <p>The <code>CustomLog</code> directive sets up a new log file
- using the defined <em>nickname</em>. The filename for the
- access log is relative to the <directive
- module="core">ServerRoot</directive> unless it begins
- with a slash.</p>
+ <p>The <directive module="mod_log_config">CustomLog</directive>
+ directive sets up a new log file using the defined
+ <em>nickname</em>. The filename for the access log is relative to
+ the <directive module="core">ServerRoot</directive> unless it
+ begins with a slash.</p>
<p>The above configuration will write log entries in a format
known as the Common Log Format (CLF). This standard format can
@@ -205,7 +205,7 @@
<dd>This is the IP address of the client (remote host) which
made the request to the server. If <directive
- module="core">HostnameLookups</directive> is
+ module="core">HostnameLookups</directive> is
set to <code>On</code>, then the server will try to determine
the hostname and log it in place of the IP address. However,
this configuration is not recommended since it can
@@ -228,7 +228,7 @@
almost never be used except on tightly controlled internal
networks. Apache httpd will not even attempt to determine
this information unless <directive
- module="core">IdentityCheck</directive> is set
+ module="core">IdentityCheck</directive> is set
to <code>On</code>.</dd>
<dt><code>frank</code> (<code>%u</code>)</dt>
@@ -352,15 +352,15 @@
<title>Multiple Access Logs</title>
<p>Multiple access logs can be created simply by specifying
- multiple <directive module="core">CustomLog</directive>
+ multiple <directive module="mod_log_config">CustomLog</directive>
directives in the configuration
file. For example, the following directives will create three
access logs. The first contains the basic CLF information,
while the second and third contain referer and browser
information. The last two <directive
- module="core">CustomLog</directive> lines show how
- to mimic the effects of the <directive module="core">ReferLog</directive>
- and <directive module="core">AgentLog</directive> directives.</p>
+ module="mod_log_config">CustomLog</directive> lines show how
+ to mimic the effects of the <code>ReferLog</code> and <code
+ >AgentLog</code> directives.</p>
<example>
LogFormat "%h %l %u %t \"%r\" %>s %b" common<br />
@@ -370,9 +370,10 @@
</example>
<p>This example also shows that it is not necessary to define a
- nickname with the <code>LogFormat</code> directive. Instead,
- the log format can be specified directly in the
- <directive module="core">CustomLog</directive> directive.</p>
+ nickname with the <directive
+ module="mod_log_config">LogFormat</directive> directive. Instead,
+ the log format can be specified directly in the <directive
+ module="mod_log_config">CustomLog</directive> directive.</p>
</section>
<section id="conditional">
@@ -385,9 +386,10 @@
environment variable must be set to indicate that the request
meets certain conditions. This is usually accomplished with
<directive module="mod_setenvif">SetEnvIf</directive>. Then the
- <code>env=</code> clause of the <code>CustomLog</code>
- directive is used to include or exclude requests where the
- environment variable is set. Some examples:</p>
+ <code>env=</code> clause of the <directive
+ module="mod_log_config">CustomLog</directive> directive is used to
+ include or exclude requests where the environment variable is
+ set. Some examples:</p>
<example>
# Mark requests from the loop-back interface<br />
@@ -526,7 +528,7 @@
hosts.</p>
<p>If <directive module="mod_log_config">CustomLog</directive>
- or <directive module="mod_log_config">ErrorLog</directive>
+ or <directive module="core">ErrorLog</directive>
directives are placed inside a
<directive module="core" type="section">VirtualHost</directive>
section, all requests or errors for that virtual host will be
@@ -567,12 +569,12 @@
<module>mod_rewrite</module>
</modulelist>
<directivelist>
- <directive module="core">PidFile</directive>
+ <directive module="mpm_common">PidFile</directive>
<directive module="mod_rewrite">RewriteLog</directive>
<directive module="mod_rewrite">RewriteLogLevel</directive>
<directive module="mod_cgi">ScriptLog</directive>
+ <directive module="mod_cgi">ScriptLogBuffer</directive>
<directive module="mod_cgi">ScriptLogLength</directive>
- <directive module="mod_cgi">ScriptBuffer</directive>
</directivelist>
</related>
@@ -581,8 +583,8 @@
<p>On startup, Apache httpd saves the process id of the parent
httpd process to the file <code>logs/httpd.pid</code>. This
- filename can be changed with the <directive module="core">PidFile
- </directive> directive. The
+ filename can be changed with the <directive
+ module="mpm_common">PidFile</directive> 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.
@@ -598,7 +600,7 @@
allows you to record the input to and output from CGI scripts.
This should only be used in testing - not for live servers.
More information is available in the <a
- href="mod/mod_cgi.html">mod_cgi documentation</a>.</p>
+ href="mod/mod_cgi.html">mod_cgi</a> documentation.</p>
</section>
<section id="rewritelog">
1.13 +27 -33 httpd-2.0/docs/manual/logs.html.en
Index: logs.html.en
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/logs.html.en,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- logs.html.en 31 Jul 2002 20:54:22 -0000 1.12
+++ logs.html.en 24 Aug 2002 11:20:22 -0000 1.13
@@ -1,8 +1,8 @@
-<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
+<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
- --><title>Log Files - Apache HTTP Server</title><link href="./style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img src="./images/sub.gif" alt="[APACHE DOCUMENTATION]"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Log Files</h1>
+ --><title>Log Files - Apache HTTP Server</title><link href="./style/manual.css" type="text/css" rel="stylesheet"></head><body><blockquote><div align="center"><img src="./images/sub.gif" alt="[APACHE DOCUMENTATION]"><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Log Files</h1>
<p>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
@@ -10,7 +10,7 @@
capabilities. This document describes how to configure its
logging capabilities, and how to understand what the logs
contain.</p>
- <ul><li><a href="#security">Security Warning</a></li><li><a href="#errorlog">Error Log</a></li><li><a href="#accesslog">Access Log</a><ul><li><a href="#common">Common Log Format</a></li><li><a href="#combined">Combined Log Format</a></li><li><a href="#multiple">Multiple Access Logs</a></li><li><a href="#conditional">Conditional Logs</a></li></ul></li><li><a href="#rotation">Rotation Logs</a></li><li><a href="#piped">Piped Logs</a></li><li><a href="#virtualhost">Virtual Hosts</a></li><li><a href="#other">Other Log Files</a><ul><li><a href="#pidfile">PID File</a></li><li><a href="#scriptlog">Script Log</a></li><li><a href="#rewritelog">Rewrite Log</a></li></ul></li></ul><hr/><h2><a name="security">Security Warning</a></h2>
+ <ul><li><a href="#security">Security Warning</a></li><li><a href="#errorlog">Error Log</a></li><li><a href="#accesslog">Access Log</a><ul><li><a href="#common">Common Log Format</a></li><li><a href="#combined">Combined Log Format</a></li><li><a href="#multiple">Multiple Access Logs</a></li><li><a href="#conditional">Conditional Logs</a></li></ul></li><li><a href="#rotation">Rotation Logs</a></li><li><a href="#piped">Piped Logs</a></li><li><a href="#virtualhost">Virtual Hosts</a></li><li><a href="#other">Other Log Files</a><ul><li><a href="#pidfile">PID File</a></li><li><a href="#scriptlog">Script Log</a></li><li><a href="#rewritelog">Rewrite Log</a></li></ul></li></ul><hr><h2><a name="security">Security Warning</a></h2>
<p>Anyone who can write to the directory where Apache is
@@ -29,7 +29,7 @@
<h2><a name="errorlog">Error Log</a></h2>
- <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br/><br/></td><td valign="top"><strong>Related Directives</strong><br/><br/><a href="./mod/mod_core.html#errorlog" class="directive"><code class="directive">ErrorLog</code></a><br/><a href="./mod/mod_core.html#loglevel" class="directive"><code class="directive">LogLevel</code></a><br/></td></tr></table>
+ <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="./mod/core.html#errorlog" class="directive"><code class="directive">ErrorLog</code></a><br><a href="./mod/core.html#loglevel" class="directive"><code class="directive">LogLevel</code></a><br></td></tr></table>
<p>The server error log, whose name and location is set by the
<a href="./mod/core.html#errorlog" class="directive"><code class="directive">ErrorLog</code></a> directive, is the
@@ -93,7 +93,7 @@
<h2><a name="accesslog">Access Log</a></h2>
- <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br/><br/><code><a href="./mod/mod_log_config.html">mod_log_config</a></code><br/><code><a href="./mod/mod_setenvif.html">mod_setenvif</a></code><br/></td><td valign="top"><strong>Related Directives</strong><br/><br/><a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a><br/><a href="./mod/mod_log_config.html#logformat" class="directive"><code class="directive">LogFormat</code></a><br/><a href="./mod/mod_setenvif.html#setenvif" class="directive"><code class="directive">SetEnvIf</code></a><br/></td></tr></table>
+ <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br><code><a href="./mod/mod_log_config.html">mod_log_config</a></code><br><code><a href="./mod/mod_setenvif.html">mod_setenvif</a></code><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a><br><a href="./mod/mod_log_config.html#logformat" class="directive"><code class="directive">LogFormat</code></a><br><a href="./mod/mod_setenvif.html#setenvif" class="directive"><code class="directive">SetEnvIf</code></a><br></td></tr></table>
<p>The server access log records all requests processed by the
server. The location and content of the access log are
@@ -116,17 +116,14 @@
<p>Various versions of Apache httpd have used other modules and
directives to control access logging, including
mod_log_referer, mod_log_agent, and the
- <code>TransferLog</code> directive. The <code>CustomLog</code>
- directive now subsumes the functionality of all the older
- directives.</p>
+ <code>TransferLog</code> directive. The <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a> directive now subsumes
+ the functionality of all the older directives.</p>
<p>The format of the access log is highly configurable. The
- format is specified using a <a href="./mod/mod_log_config.html#
- customlog" class="directive"><code class="directive">
- CustomLog</code></a> that
+ format is specified using a <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a> that
looks much like a C-style printf(1) format string. Some
examples are presented in the next sections. For a complete
- list of the possible contents of the format string, see the <a href="mod/mod_log_config.html">mod_log_config
+ list of the possible contents of the format string, see the <a href="mod/mod_log_config.html#formats">mod_log_config
documentation</a>.</p>
<h3><a name="common">Common Log Format</a></h3>
@@ -152,10 +149,11 @@
control characters "<code>\n</code>" for new-line and
"<code>\t</code>" for tab.</p>
- <p>The <code>CustomLog</code> directive sets up a new log file
- using the defined <em>nickname</em>. The filename for the
- access log is relative to the <a href="./mod/core.html#serverroot" class="directive"><code class="directive">ServerRoot</code></a> unless it begins
- with a slash.</p>
+ <p>The <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a>
+ directive sets up a new log file using the defined
+ <em>nickname</em>. The filename for the access log is relative to
+ the <a href="./mod/core.html#serverroot" class="directive"><code class="directive">ServerRoot</code></a> unless it
+ begins with a slash.</p>
<p>The above configuration will write log entries in a format
known as the Common Log Format (CLF). This standard format can
@@ -318,14 +316,13 @@
<p>Multiple access logs can be created simply by specifying
- multiple <a href="./mod/core.html#customlog" class="directive"><code class="directive">CustomLog</code></a>
+ multiple <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a>
directives in the configuration
file. For example, the following directives will create three
access logs. The first contains the basic CLF information,
while the second and third contain referer and browser
- information. The last two <a href="./mod/core.html#customlog" class="directive"><code class="directive">CustomLog</code></a> lines show how
- to mimic the effects of the <a href="./mod/core.html#referlog" class="directive"><code class="directive">ReferLog</code></a>
- and <a href="./mod/core.html#agentlog" class="directive"><code class="directive">AgentLog</code></a> directives.</p>
+ information. The last two <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a> lines show how
+ to mimic the effects of the <code>ReferLog</code> and <code>AgentLog</code> directives.</p>
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
LogFormat "%h %l %u %t \"%r\" %>s %b" common<br>
@@ -335,9 +332,8 @@
</code></td></tr></table></blockquote>
<p>This example also shows that it is not necessary to define a
- nickname with the <code>LogFormat</code> directive. Instead,
- the log format can be specified directly in the
- <a href="./mod/core.html#customlog" class="directive"><code class="directive">CustomLog</code></a> directive.</p>
+ nickname with the <a href="./mod/mod_log_config.html#logformat" class="directive"><code class="directive">LogFormat</code></a> directive. Instead,
+ the log format can be specified directly in the <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a> directive.</p>
<h3><a name="conditional">Conditional Logs</a></h3>
@@ -349,9 +345,9 @@
environment variable must be set to indicate that the request
meets certain conditions. This is usually accomplished with
<a href="./mod/mod_setenvif.html#setenvif" class="directive"><code class="directive">SetEnvIf</code></a>. Then the
- <code>env=</code> clause of the <code>CustomLog</code>
- directive is used to include or exclude requests where the
- environment variable is set. Some examples:</p>
+ <code>env=</code> clause of the <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a> directive is used to
+ include or exclude requests where the environment variable is
+ set. Some examples:</p>
<blockquote><table cellpadding="10"><tr><td bgcolor="#eeeeee"><code>
# Mark requests from the loop-back interface<br>
@@ -480,7 +476,7 @@
hosts.</p>
<p>If <a href="./mod/mod_log_config.html#customlog" class="directive"><code class="directive">CustomLog</code></a>
- or <a href="./mod/mod_log_config.html#errorlog" class="directive"><code class="directive">ErrorLog</code></a>
+ or <a href="./mod/core.html#errorlog" class="directive"><code class="directive">ErrorLog</code></a>
directives are placed inside a
<a href="./mod/core.html#virtualhost" class="directive"><code class="directive"><VirtualHost></code></a>
section, all requests or errors for that virtual host will be
@@ -511,16 +507,14 @@
<h2><a name="other">Other Log Files</a></h2>
- <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br/><br/><code><a href="./mod/mod_cgi.html">mod_cgi</a></code><br/><code><a href="./mod/mod_rewrite.html">mod_rewrite</a></code><br/></td><td valign="top"><strong>Related Directives</strong><br/><br/><a href="./mod/core.html#pidfile" class="directive"><code class="directive">PidFile</code></a><br/><a href="./mod/mod_rewrite.html#rewritelog" class="directive"><code class="directive">RewriteLog</code></a><br/><a href="./mod/mod_rewrite.html#rewriteloglevel" class="directive"><code class="directive">RewriteLogLevel</code></a><br/><a href="./mod/mod_cgi.html#scriptlog" class="directive"><code class="directive">ScriptLog</code></a><br/><a href="./mod/mod_cgi.html#scriptloglength" class="directive"><code class="directive">ScriptLogLength</code></a><br/><a href="./mod/mod_cgi.html#scriptbuffer" class="directive"><code class="directive">ScriptBuffer</code></a><br/></td></tr></table>
+ <table border="1"><tr><td valign="top"><strong>Related Modules</strong><br><br><code><a href="./mod/mod_cgi.html">mod_cgi</a></code><br><code><a href="./mod/mod_rewrite.html">mod_rewrite</a></code><br></td><td valign="top"><strong>Related Directives</strong><br><br><a href="./mod/mpm_common.html#pidfile" class="directive"><code class="directive">PidFile</code></a><br><a href="./mod/mod_rewrite.html#rewritelog" class="directive"><code class="directive">RewriteLog</code></a><br><a href="./mod/mod_rewrite.html#rewriteloglevel" class="directive"><code class="directive">RewriteLogLevel</code></a><br><a href="./mod/mod_cgi.html#scriptlog" class="directive"><code class="directive">ScriptLog</code></a><br><a href="./mod/mod_cgi.html#scriptlogbuffer" class="directive"><code class="directive">ScriptLogBuffer</code></a><br><a href="./mod/mod_cgi.html#scriptloglength" class="directive"><code class="directive">ScriptLogLength</code></a><br></td></tr></table>
<h3><a name="pidfile">PID File</a></h3>
<p>On startup, Apache httpd saves the process id of the parent
httpd process to the file <code>logs/httpd.pid</code>. This
- filename can be changed with the <a href="./mod/core.html#pidfile
- " class="directive"><code class="directive">PidFile
- </code></a> directive. The
+ filename can be changed with the <a href="./mod/mpm_common.html#pidfile" class="directive"><code class="directive">PidFile</code></a> 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.
@@ -535,7 +529,7 @@
<a href="./mod/mod_cgi.html#scriptlog" class="directive"><code class="directive">ScriptLog</code></a> directive
allows you to record the input to and output from CGI scripts.
This should only be used in testing - not for live servers.
- More information is available in the <a href="mod/mod_cgi.html">mod_cgi documentation</a>.</p>
+ More information is available in the <a href="mod/mod_cgi.html">mod_cgi</a> documentation.</p>
<h3><a name="rewritelog">Rewrite Log</a></h3>
@@ -547,4 +541,4 @@
the rewriting engine transforms requests. The level of detail
is controlled by the <a href="./mod/mod_rewrite.html#rewriteloglevel" class="directive"><code class="directive">RewriteLogLevel</code></a> directive.</p>
- <hr/></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="./images/index.gif" alt="Index"/></a><a href="./"><img src="./images/home.gif" alt="Home"/></a></body></html>
\ No newline at end of file
+ <hr></blockquote><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img src="./images/index.gif" alt="Index"></a><a href="./"><img src="./images/home.gif" alt="Home"></a></body></html>
\ No newline at end of file