You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by ta...@apache.org on 2008/05/10 02:47:53 UTC
svn commit: r654996 - in /httpd/httpd/branches/2.2.x/docs: man/rotatelogs.8
manual/programs/rotatelogs.html.en manual/programs/rotatelogs.xml
Author: takashi
Date: Fri May 9 17:47:52 2008
New Revision: 654996
URL: http://svn.apache.org/viewvc?rev=654996&view=rev
Log:
Add a new option "-f" (taken from r632355)
Modified:
httpd/httpd/branches/2.2.x/docs/man/rotatelogs.8
httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.html.en
httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.xml
Modified: httpd/httpd/branches/2.2.x/docs/man/rotatelogs.8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/man/rotatelogs.8?rev=654996&r1=654995&r2=654996&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/man/rotatelogs.8 (original)
+++ httpd/httpd/branches/2.2.x/docs/man/rotatelogs.8 Fri May 9 17:47:52 2008
@@ -19,7 +19,7 @@
.el .ne 3
.IP "\\$1" \\$2
..
-.TH "ROTATELOGS" 8 "2007-12-09" "Apache HTTP Server" "rotatelogs"
+.TH "ROTATELOGS" 8 "2008-05-09" "Apache HTTP Server" "rotatelogs"
.SH NAME
rotatelogs \- Piped logging program to rotate Apache logs
@@ -27,7 +27,7 @@
.SH "SYNOPSIS"
.PP
-\fBrotatelogs\fR [ -\fBl\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fRM [ \fIoffset\fR ]
+\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBf\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fRM [ \fIoffset\fR ]
.SH "SUMMARY"
@@ -43,6 +43,9 @@
-l
Causes the use of local time rather than GMT as the base for the interval or for strftime(3) formatting with size-based rotation\&. Note that using -l in an environment which changes the GMT offset (such as for BST or DST) can lead to unpredictable results!
.TP
+-f
+Causes the logfile to be opened immediately, as soon as rotatelogs starts, instead of waiting for the first logfile entry to be read (for non-busy sites, there may be a substantial delay between when the server is started and when the first request is handled, meaning that the associated logfile does not "exist" until then, which causes problems from some automated logging tools)
+.TP
\fIlogfile\fR
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\&. 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)\&.
.TP
Modified: httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.html.en?rev=654996&r1=654995&r2=654996&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.html.en (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.html.en Fri May 9 17:47:52 2008
@@ -37,6 +37,7 @@
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
+ [ -<strong>f</strong> ]
<var>logfile</var>
<var>rotationtime</var>|<var>filesize</var>M
[ <var>offset</var> ]</code></p>
@@ -53,6 +54,15 @@
changes the GMT offset (such as for BST or DST) can lead to unpredictable
results!</dd>
+<dt><code>-f</code></dt>
+<dd>Causes the logfile to be opened immediately, as soon as
+<code>rotatelogs</code> starts, instead of waiting for the
+first logfile entry to be read (for non-busy sites, there may be
+a substantial delay between when the server is started
+and when the first request is handled, meaning that the
+associated logfile does not "exist" until then, which
+causes problems from some automated logging tools)</dd>
+
<dt><code><var>logfile</var></code></dt>
<dd>The path plus basename of the logfile. If <var>logfile</var>
Modified: httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.xml?rev=654996&r1=654995&r2=654996&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/programs/rotatelogs.xml Fri May 9 17:47:52 2008
@@ -35,6 +35,7 @@
<p><code><strong>rotatelogs</strong>
[ -<strong>l</strong> ]
+ [ -<strong>f</strong> ]
<var>logfile</var>
<var>rotationtime</var>|<var>filesize</var>M
[ <var>offset</var> ]</code></p>
@@ -51,6 +52,15 @@
changes the GMT offset (such as for BST or DST) can lead to unpredictable
results!</dd>
+<dt><code>-f</code></dt>
+<dd>Causes the logfile to be opened immediately, as soon as
+<code>rotatelogs</code> starts, instead of waiting for the
+first logfile entry to be read (for non-busy sites, there may be
+a substantial delay between when the server is started
+and when the first request is handled, meaning that the
+associated logfile does not "exist" until then, which
+causes problems from some automated logging tools)</dd>
+
<dt><code><var>logfile</var></code></dt>
<dd>The path plus basename of the logfile. If <var>logfile</var>