httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject cvs commit: httpd-docs-1.3/htdocs/manual/mod core.html.en mod_log_config.html
Date Fri, 10 Aug 2001 15:51:13 GMT
slive       01/08/10 08:51:13

  Modified:    htdocs/manual configuring.html.en
               htdocs/manual/mod core.html.en mod_log_config.html
  Eliminate duplicated info after adding new document on logging.
  By the way, I'm still very interested in feedback on how to
  improve logs.html.
  Revision  Changes    Path
  1.8       +0 -48     httpd-docs-1.3/htdocs/manual/configuring.html.en
  Index: configuring.html.en
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/configuring.html.en,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -d -b -u -r1.7 -r1.8
  --- configuring.html.en	2001/01/11 06:07:11	1.7
  +++ configuring.html.en	2001/08/10 15:51:13	1.8
  @@ -21,7 +21,6 @@
   <li><a href="#modules">Modules</a></li>
   <li><a href="#scope">Scope of Directives</a></li>
   <li><a href="#htaccess">.htaccess Files</a></li>
  -<li><a href="#logs">Log Files</a></li>
  @@ -199,53 +198,6 @@
   configuring the <A
   directive in the main configuration files.
  -<H2><a name="logs">Log files</a></H2>
  -<!-- This section should be moved to its own file -->
  -<H3>security warning</H3>
  -Anyone who can write to the directory where Apache is writing a
  -log file can almost certainly gain access to the uid that the server is
  -started as, which is normally root.  Do <EM>NOT</EM> give people write
  -access to the directory the logs are stored in without being aware of
  -the consequences; see the <A HREF="misc/security_tips.html">security tips</A>
  -document for details.
  -<H3>pid file</H3>
  -<P>On startup, Apache saves the process id of the parent httpd process to
  -the file <CODE>logs/</CODE>. This filename can be changed
  -with the <A HREF="mod/core.html#pidfile">PidFile</A> directive. The
  -process-id is for use by the administrator in restarting and
  -terminating the daemon: on Unix, a HUP or USR1 signal causes the
  -daemon to re-read its configuration files and a TERM signal causes it
  -to die gracefully; on Windows, use the -k command line option instead.
  -For more information see the <A HREF="stopping.html">Stopping and
  -Restarting</A> page.
  -If the process dies (or is killed) abnormally, then it will be necessary to
  -kill the children httpd processes.
  -<H3>Error log</H3>
  -<P>The server will log error messages to a log file, by default
  -<CODE>logs/error_log</CODE> on Unix or <CODE>logs/error.log</CODE>
  -Windows and OS/2. The filename can be set using the <A
  -HREF="mod/core.html#errorlog">ErrorLog</A> directive; different error
  -logs can be set for different <A
  -HREF="mod/core.html#virtualhost">virtual hosts</A>.
  -<H3>Transfer log</H3>
  -<P>The server will typically log each request to a transfer file, by
  -default <CODE>logs/access_log</CODE> on Unix or
  -<CODE>logs/access.log</CODE> on Windows and OS/2. The filename can be
  -set using a <A HREF="mod/mod_log_config.html#customlog">CustomLog</A>
  -directive; different transfer logs can be set for different <A
  -HREF="mod/core.html#virtualhost">virtual hosts</A>.
   <!--#include virtual="footer.html" -->
  1.192     +1 -0      httpd-docs-1.3/htdocs/manual/mod/core.html.en
  Index: core.html.en
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/core.html.en,v
  retrieving revision 1.191
  retrieving revision 1.192
  diff -u -d -b -u -r1.191 -r1.192
  --- core.html.en	2001/08/03 23:40:30	1.191
  +++ core.html.en	2001/08/10 15:51:13	1.192
  @@ -1168,6 +1168,7 @@
   than the user that starts the server.
   <P><STRONG>See also:</STRONG> <A HREF="#loglevel">LogLevel</A>
  +and <a href="../logs.html">Apache Log Files</a>
   <H2><A NAME="files">&lt;Files&gt; directive</A></H2>
  1.48      +3 -93     httpd-docs-1.3/htdocs/manual/mod/mod_log_config.html
  Index: mod_log_config.html
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_log_config.html,v
  retrieving revision 1.47
  retrieving revision 1.48
  diff -u -d -b -u -r1.47 -r1.48
  --- mod_log_config.html	2001/02/28 03:43:40	1.47
  +++ mod_log_config.html	2001/08/10 15:51:13	1.48
  @@ -58,6 +58,8 @@
   logged to multiple files.
  +<p>See also: <a href="../logs.html">Apache Log Files</a>.</p>
  @@ -66,58 +68,8 @@
   <LI><A HREF="#logformat">LogFormat</A></LI>
   <LI><A HREF="#transferlog">TransferLog</A></LI>
  -<H2>Log File Formats</H2>
  -<p>Unless told otherwise with <TT>LogFormat</TT>, the log files
  -created by <TT>TransferLog</TT> will be in standard "Common Log
  -Format" (CLF). The contents of each line in a CLF file are explained
  -below. Alternatively, the log file can be customized (and if multiple
  -log files are used, each can have a different format). Custom formats
  -are set with <CODE>LogFormat</CODE> and <CODE>CustomLog</CODE>.</p>
  -<H3>Common Log Format</H3>
  -<p>The Common Log Format (CLF) file contains a separate line for each
  -request. A line is composed of several tokens separated by spaces:</p>
  -host ident authuser date request status bytes
  -If a token does not have a value then it is represented by a hyphen (-).
  -The meanings and values of these tokens are as follows:
  -<DD>The fully-qualified domain name of the client, or its IP number if the
  -name is not available.
  -<DD>If <A HREF="core.html#identitycheck">IdentityCheck</A> is enabled
and the
  -client machine runs identd, then this is the identity information reported
  -by the client.
  -<DD>If the request was for an password protected document, then this is
  -the userid used in the request.
  -<DD>The date and time of the request, in the following format:
  -<DL><DD><BLOCKQUOTE><CODE> date = [day/month/year:hour:minute:second
zone] <BR>
  -day = 2*digit<BR>
  -month = 3*letter<BR>
  -year = 4*digit<BR>
  -hour = 2*digit<BR>
  -minute = 2*digit<BR>
  -second = 2*digit<BR>
  -zone = (`+' | `-') 4*digit</CODE></BLOCKQUOTE></DL>
  -<DD>The request line from the client, enclosed in double quotes
  -<DD>The three digit status code returned to the client.
  -<DD>The number of bytes in the object returned to the client, not including
  -any headers.
  -<H3><A NAME="formats">Custom Log Formats</A></H3>
  +<H2><A NAME="formats">Custom Log Formats</A></H2>
   <p>The format argument to the <CODE>LogFormat</CODE> and
   <CODE>CustomLog</CODE> directives is a string. This string is logged
  @@ -212,54 +164,12 @@
   vhost matching algorithm in order to decide what host really served
   the request.</p>
  -<H2>Using Multiple Log Files</H2>
  -<p>The <CODE>TransferLog</CODE> and <CODE>CustomLog</CODE>
directives can
  -be given more than once to log requests to multiple log files. Unless
  -the conditional form of <code>CustomLog</code> is used, each
  -request will be logged to all the log files defined by either of these
  -<H3>Use with Virtual Hosts</H3>
  -<p>If a &lt;VirtualHost&gt; section does not contain any
  -<TT>TransferLog</TT> or <TT>CustomLog</TT> directives, the
  -logs defined for the main server will be used. If it does
  -contain one or more of these directives, requests serviced by
  -this virtual host will only be logged in the log files defined
  -within its definition, not in any of the main server's log files.
  -See the examples below.</p>
   <H2>Security Considerations</H2>
   <p>See the <A HREF="../misc/security_tips.html#serverroot">security tips</A>
   document for details on why your security could be compromised if the
   directory where logfiles are stored is writable by anyone other than
   the user that starts the server.</p>
  -<h2>Resetting the Log Files</h2>
  -<p>The access log file typically grows 1MB or more for each 10,000
  -requests.  It will probably be necessary to move or delete the log
  -file on a regular basis.  This cannot be done while the server is
  -still running, because Apache will continue writing to the old log
  -file.  Instead, the server must be <a
  -href="../stopping.html">restarted</a> after the log file is moved or
  -deleted so that it will open a new log.</p>
  -<p>A typical scenario is:</p>
  -   mv access_log access_log.old
  -   apachectl graceful
  -   # wait for all requests to the old server to complete
  -   # before doing anything with access_log.old
  -<p>Alternatively, log files can be <a
  -href="../misc/FAQ.html#rotate">rotated automatically</a> be writing
  -them through a pipe to a program designed for that purpose such
  -as <a href="../programs/rotatelogs.html">rotatelogs</a>.</p>
   <H2>Compatibility notes</H2>

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message