You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by mr...@apache.org on 2014/08/07 01:31:13 UTC
svn commit: r1616371 - in /httpd/httpd/trunk/docs: man/rotatelogs.8
manual/expr.html.en manual/programs/rotatelogs.html.en
manual/programs/rotatelogs.xml.ko manual/programs/rotatelogs.xml.tr
Author: mrumph
Date: Wed Aug 6 23:31:12 2014
New Revision: 1616371
URL: http://svn.apache.org/r1616371
Log:
Generated doc changes.
Modified:
httpd/httpd/trunk/docs/man/rotatelogs.8
httpd/httpd/trunk/docs/manual/expr.html.en
httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en
httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.ko
httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.tr
Modified: httpd/httpd/trunk/docs/man/rotatelogs.8
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/rotatelogs.8?rev=1616371&r1=1616370&r2=1616371&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/man/rotatelogs.8 (original)
+++ httpd/httpd/trunk/docs/man/rotatelogs.8 Wed Aug 6 23:31:12 2014
@@ -19,7 +19,7 @@
.el .ne 3
.IP "\\$1" \\$2
..
-.TH "ROTATELOGS" 8 "2014-06-26" "Apache HTTP Server" "rotatelogs"
+.TH "ROTATELOGS" 8 "2014-08-06" "Apache HTTP Server" "rotatelogs"
.SH NAME
rotatelogs \- Piped logging program to rotate Apache logs
@@ -71,7 +71,7 @@ Create log file for each interval, even
Use a circular list of filenames without timestamps\&. With -n 3, the series of log files opened would be "logfile", "logfile\&.1", "logfile\&.2", then overwriting "logfile"\&. Available in 2\&.4\&.5 and later\&.
.TP
\fIlogfile\fR
-.PP The path plus basename of the logfile\&. If \fIlogfile\fR includes any '%' characters, it is treated as a format string for strftime(3)\&. Otherwise, the suffix \fI\&.nnnnnnnnnn\fR is automatically added and is the time in seconds (unless the -t option is used)\&. Both formats compute the start time from the beginning of the current period\&. For example, if a rotation time of 86400 is specified, the hour, minute, and second fields created from the strftime(3) format will all be zero, referring to the beginning of the current 24-hour period (midnight)\&. .PP When using strftime(3) filename formatting, be sure the log file format has enough granularity to produce a different file name each time the logs are rotated\&. Otherwise rotation will overwrite the same file instead of starting a new one\&. For example, if \fIlogfile\fR was /var/logs/errorlog\&.%Y-%m-%d with log rotation at 5 megabytes, but 5 megabytes was reached twice in the same day, the same log file name would be prod
uced and log rotation would keep writing to the same file\&.
+.PP The path plus basename of the logfile\&. If \fIlogfile\fR includes any '%' characters, it is treated as a format string for strftime(3)\&. Otherwise, the suffix \fI\&.nnnnnnnnnn\fR is automatically added and is the time in seconds (unless the -t option is used)\&. Both formats compute the start time from the beginning of the current period\&. For example, if a rotation time of 86400 is specified, the hour, minute, and second fields created from the strftime(3) format will all be zero, referring to the beginning of the current 24-hour period (midnight)\&. .PP When using strftime(3) filename formatting, be sure the log file format has enough granularity to produce a different file name each time the logs are rotated\&. Otherwise rotation will overwrite the same file instead of starting a new one\&. For example, if \fIlogfile\fR was /var/log/errorlog\&.%Y-%m-%d with log rotation at 5 megabytes, but 5 megabytes was reached twice in the same day, the same log file name would be produ
ced and log rotation would keep writing to the same file\&.
.TP
\fIrotationtime\fR
The time between log file rotations in seconds\&. The rotation occurs at the beginning of this interval\&. For example, if the rotation time is 3600, the log file will be rotated at the beginning of every hour; if the rotation time is 86400, the log file will be rotated every night at midnight\&. (If no data is logged during an interval, no file will be created\&.)
@@ -86,25 +86,25 @@ The number of minutes offset from UTC\&.
.nf
- CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
+ CustomLog "|bin/rotatelogs /var/log/logfile 86400" common
.fi
.PP
-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 synchronize cron scripts with it)\&. At the end of each rotation time (here after 24 hours) a new log is started\&.
+This creates the files /var/log/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 synchronize cron scripts with it)\&. At the end of each rotation time (here after 24 hours) a new log is started\&.
.nf
- CustomLog "|bin/rotatelogs -l /var/logs/logfile\&.%Y\&.%m\&.%d 86400" common
+ CustomLog "|bin/rotatelogs -l /var/log/logfile\&.%Y\&.%m\&.%d 86400" common
.fi
.PP
-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\&.
+This creates the files /var/log/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\&.
.nf
- CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common
+ CustomLog "|bin/rotatelogs /var/log/logfile 5M" common
.fi
@@ -113,7 +113,7 @@ This configuration will rotate the logfi
.nf
- ErrorLog "|bin/rotatelogs /var/logs/errorlog\&.%Y-%m-%d-%H_%M_%S 5M"
+ ErrorLog "|bin/rotatelogs /var/log/errorlog\&.%Y-%m-%d-%H_%M_%S 5M"
.fi
@@ -122,12 +122,12 @@ This configuration will rotate the error
.nf
- CustomLog "|bin/rotatelogs -t /var/logs/logfile 86400" common
+ CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common
.fi
.PP
-This creates the file /var/logs/logfile, truncating the file at startup and then truncating the file once per day\&. It is expected in this scenario that a separate process (such as tail) would process the file in real time\&.
+This creates the file /var/log/logfile, truncating the file at startup and then truncating the file once per day\&. It is expected in this scenario that a separate process (such as tail) would process the file in real time\&.
.SH "PORTABILITY"
Modified: httpd/httpd/trunk/docs/manual/expr.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/expr.html.en?rev=1616371&r1=1616370&r2=1616371&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/expr.html.en (original)
+++ httpd/httpd/trunk/docs/manual/expr.html.en Wed Aug 6 23:31:12 2014
@@ -197,7 +197,7 @@ listfunction ::= listfuncname "<strong>(
<tr><td><code>REMOTE_HOST</code></td>
<td>The host name of the remote host</td></tr>
<tr class="odd"><td><code>REMOTE_USER</code></td>
- <td>The name of the authenticated user (if any)</td></tr>
+ <td>The name of the authenticated user, if any (not available during <code class="directive"><If ></code>)</td></tr>
<tr><td><code>REMOTE_IDENT</code></td>
<td>The user name set by <code class="module"><a href="./mod/mod_ident.html">mod_ident</a></code></td></tr>
<tr class="odd"><td><code>SERVER_NAME</code></td>
@@ -231,7 +231,7 @@ listfunction ::= listfuncname "<strong>(
<td>The configured <code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code> (e.g.
"<code>basic</code>")</td></tr>
<tr><td><code>CONTENT_TYPE</code></td>
- <td>The content type of the response</td></tr>
+ <td>The content type of the response (not available during <code class="directive"><If ></code>)</td></tr>
<tr class="odd"><td><code>HANDLER</code></td>
<td>The name of the <a href="handler.html">handler</a> creating
the response</td></tr>
@@ -242,7 +242,7 @@ listfunction ::= listfuncname "<strong>(
<td>"<code>on</code>" if the connection uses IPv6,
"<code>off</code>" otherwise</td></tr>
<tr><td><code>REQUEST_STATUS</code></td>
- <td>The HTTP error status of the request</td></tr>
+ <td>The HTTP error status of the request (not available during <code class="directive"><If ></code>)</td></tr>
<tr class="odd"><td><code>REQUEST_LOG_ID</code></td>
<td>The error log id of the request (see
<code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
Modified: httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en?rev=1616371&r1=1616370&r2=1616371&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en Wed Aug 6 23:31:12 2014
@@ -138,7 +138,7 @@ be sure the log file format has enough g
a different file name each time the logs are rotated. Otherwise
rotation will overwrite the same file instead of starting a new
one. For example, if <var>logfile</var> was
-<code>/var/logs/errorlog.%Y-%m-%d</code> with log rotation at 5
+<code>/var/log/errorlog.%Y-%m-%d</code> with log rotation at 5
megabytes, but 5 megabytes was reached twice in the same day, the
same log file name would be produced and log rotation would keep
writing to the same file.</p>
@@ -178,32 +178,32 @@ an offset.</dd>
<h2><a name="examples" id="examples">Examples</a></h2>
<div class="example"><p><code>
- CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
+ CustomLog "|bin/rotatelogs /var/log/logfile 86400" common
</code></p></div>
- <p>This creates the files /var/logs/logfile.nnnn where nnnn is
+ <p>This creates the files /var/log/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
synchronize cron scripts with it). At the end of each rotation
time (here after 24 hours) a new log is started.</p>
<div class="example"><p><code>
- CustomLog "|bin/rotatelogs -l /var/logs/logfile.%Y.%m.%d 86400" common
+ CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m.%d 86400" common
</code></p></div>
- <p>This creates the files /var/logs/logfile.yyyy.mm.dd where
+ <p>This creates the files /var/log/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>
<div class="example"><p><code>
- CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common
+ CustomLog "|bin/rotatelogs /var/log/logfile 5M" common
</code></p></div>
<p>This configuration will rotate the logfile whenever it reaches
a size of 5 megabytes.</p>
<div class="example"><p><code>
- ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M"
+ ErrorLog "|bin/rotatelogs /var/log/errorlog.%Y-%m-%d-%H_%M_%S 5M"
</code></p></div>
<p>This configuration will rotate the error logfile whenever it
reaches a size of 5 megabytes, and the suffix to the logfile name
@@ -211,10 +211,10 @@ an offset.</dd>
<code>errorlog.YYYY-mm-dd-HH_MM_SS</code>.</p>
<div class="example"><p><code>
- CustomLog "|bin/rotatelogs -t /var/logs/logfile 86400" common
+ CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common
</code></p></div>
- <p>This creates the file /var/logs/logfile, truncating the file at
+ <p>This creates the file /var/log/logfile, truncating the file at
startup and then truncating the file once per day. It is expected
in this scenario that a separate process (such as tail) would
process the file in real time.</p>
Modified: httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.ko
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.ko?rev=1616371&r1=1616370&r2=1616371&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.ko [euc-kr] (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.ko [euc-kr] Wed Aug 6 23:31:12 2014
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
-<!-- English Revision: 420993:1604535 (outdated) -->
+<!-- English Revision: 420993:1615362 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
Modified: httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.tr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.tr?rev=1616371&r1=1616370&r2=1616371&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.tr [utf-8] (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml.tr [utf-8] Wed Aug 6 23:31:12 2014
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
-<!-- English Revision: 1189220:1604535 (outdated) -->
+<!-- English Revision: 1189220:1615362 (outdated) -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
Reviewed by: Orhan Berent <berent belgeler.org>