httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From minf...@apache.org
Subject svn commit: r910732 - in /httpd/httpd/trunk/docs: man/htcacheclean.8 man/rotatelogs.8 manual/programs/htcacheclean.html.en manual/programs/rotatelogs.html.en
Date Tue, 16 Feb 2010 22:23:09 GMT
Author: minfrin
Date: Tue Feb 16 22:23:09 2010
New Revision: 910732

URL: http://svn.apache.org/viewvc?rev=910732&view=rev
Log:
Update transformations.

Modified:
    httpd/httpd/trunk/docs/man/htcacheclean.8
    httpd/httpd/trunk/docs/man/rotatelogs.8
    httpd/httpd/trunk/docs/manual/programs/htcacheclean.html.en
    httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en

Modified: httpd/httpd/trunk/docs/man/htcacheclean.8
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/htcacheclean.8?rev=910732&r1=910731&r2=910732&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/man/htcacheclean.8 (original)
+++ httpd/httpd/trunk/docs/man/htcacheclean.8 Tue Feb 16 22:23:09 2010
@@ -19,7 +19,7 @@
 .el .ne 3
 .IP "\\$1" \\$2
 ..
-.TH "HTCACHECLEAN" 8 "2008-04-21" "Apache HTTP Server" "htcacheclean"
+.TH "HTCACHECLEAN" 8 "2010-02-16" "Apache HTTP Server" "htcacheclean"
 
 .SH NAME
 htcacheclean \- Clean up the disk cache
@@ -30,7 +30,7 @@
 \fBhtcacheclean\fR [ -\fBD\fR ] [ -\fBv\fR ] [ -\fBt\fR ] [ -\fBr\fR ] [ -\fBn\fR ] -\fBp\fR\fIpath\fR
-\fBl\fR\fIlimit\fR
  
 .PP
-\fBhtcacheclean\fR [ -\fBn\fR ] [ -\fBt\fR ] [ -\fBi\fR ] -\fBd\fR\fIinterval\fR -\fBp\fR\fIpath\fR
-\fBl\fR\fIlimit\fR
+\fBhtcacheclean\fR [ -\fBn\fR ] [ -\fBt\fR ] [ -\fBi\fR ] [ -\fBP\fR\fIpidfile\fR ] -\fBd\fR\fIinterval\fR
-\fBp\fR\fIpath\fR -\fBl\fR\fIlimit\fR
  
 
 .SH "SUMMARY"
@@ -64,6 +64,9 @@
 -p\fIpath\fR
 Specify \fIpath\fR as the root directory of the disk cache\&. This should be the same
value as specified with the CacheRoot directive\&.  
 .TP
+-P\fIpidfile\fR
+Specify \fIpidfile\fR as the name of the file to write the process ID to when daemonized\&.
 
+.TP
 -l\fIlimit\fR
 Specify \fIlimit\fR as the total disk cache size limit\&. The value is expressed in bytes
by default (or attaching B to the number)\&. Attach K for Kbytes or M for MBytes\&.
 
 .TP

Modified: httpd/httpd/trunk/docs/man/rotatelogs.8
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/rotatelogs.8?rev=910732&r1=910731&r2=910732&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/man/rotatelogs.8 (original)
+++ httpd/httpd/trunk/docs/man/rotatelogs.8 Tue Feb 16 22:23:09 2010
@@ -19,7 +19,7 @@
 .el .ne 3
 .IP "\\$1" \\$2
 ..
-.TH "ROTATELOGS" 8 "2009-02-02" "Apache HTTP Server" "rotatelogs"
+.TH "ROTATELOGS" 8 "2010-02-16" "Apache HTTP Server" "rotatelogs"
 
 .SH NAME
 rotatelogs \- Piped logging program to rotate Apache logs
@@ -46,11 +46,14 @@
 -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
+-t
+Causes the logfile to be truncated instead of rotated\&. This is useful when a log is
processed in real time by a command like tail, and there is no need for archived data\&.
No suffix will be added to the filename, however format strings containing '%' characters
will be respected\&.  
+.TP
 -v
 Produce verbose output on STDERR\&. The output contains the result of the configuration
parsing, and all file open and close actions\&.  
 .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)\&.  
+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)\&.  
 .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\&.)
 
@@ -99,6 +102,15 @@
 .PP
 This configuration will rotate the error logfile whenever it reaches a size of 5 megabytes,
and the suffix to the logfile name will be created of the form errorlog\&.YYYY-mm-dd-HH_MM_SS\&.
  
+.nf
+
+     CustomLog "|bin/rotatelogs -t /var/logs/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\&.
+ 
 .SH "PORTABILITY"
  
 .PP

Modified: httpd/httpd/trunk/docs/manual/programs/htcacheclean.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/htcacheclean.html.en?rev=910732&r1=910731&r2=910732&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/htcacheclean.html.en (original)
+++ httpd/httpd/trunk/docs/manual/programs/htcacheclean.html.en Tue Feb 16 22:23:09 2010
@@ -50,6 +50,7 @@
     [ -<strong>n</strong> ]
     [ -<strong>t</strong> ]
     [ -<strong>i</strong> ]
+    [ -<strong>P</strong><var>pidfile</var> ]
     -<strong>d</strong><var>interval</var>
     -<strong>p</strong><var>path</var>
     -<strong>l</strong><var>limit</var></code></p>
@@ -95,6 +96,10 @@
     <dd>Specify <var>path</var> as the root directory of the disk cache.
This
     should be the same value as specified with the <code class="directive"><a href="../mod/mod_disk_cache.html#cacheroot">CacheRoot</a></code>
directive.</dd>
 
+    <dt><code>-P<var>pidfile</var></code></dt>
+    <dd>Specify <var>pidfile</var> as the name of the file to write the
+    process ID to when daemonized.</dd>
+
     <dt><code>-l<var>limit</var></code></dt>
     <dd>Specify <var>limit</var> as the total disk cache size limit. The
value
     is expressed in bytes by default (or attaching <code>B</code> to the

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=910732&r1=910731&r2=910732&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en Tue Feb 16 22:23:09 2010
@@ -65,6 +65,14 @@
 associated logfile does not "exist" until then, which
 causes problems from some automated logging tools)</dd>
 
+<dt><code>-t</code></dt>
+<dd>Causes the logfile to be truncated instead of rotated. This is
+useful when a log is processed in real time by a command like tail,
+and there is no need for archived data. No suffix will be added to
+the filename, however format strings containing '%' characters
+will be respected.
+</dd>
+
 <dt><code>-v</code></dt>
 <dd>Produce verbose output on STDERR. The output contains
 the result of the configuration parsing, and all file open and
@@ -76,11 +84,12 @@
 includes any '%' characters, it is treated as a format string for
 <code>strftime(3)</code>.  Otherwise, the suffix
 <var>.nnnnnnnnnn</var> 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
-<code>strftime(3)</code> format will all be zero, referring to the
-beginning of the current 24-hour period (midnight).</dd>
+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 <code>strftime(3)</code> format will
+all be zero, referring to the beginning of the current 24-hour
+period (midnight).</dd>
 
 <dt><code><var>rotationtime</var></code></dt>
 
@@ -148,6 +157,15 @@
      will be created of the form
      <code>errorlog.YYYY-mm-dd-HH_MM_SS</code>.</p>
  
+<div class="example"><p><code>
+     CustomLog "|bin/rotatelogs -t /var/logs/logfile 86400" common
+</code></p></div>
+
+     <p>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.</p>
+
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"
/></a></div>
 <div class="section">
 <h2><a name="portability" id="portability">Portability</a></h2>



Mime
View raw message