74 lines
4.3 KiB
Plaintext
74 lines
4.3 KiB
Plaintext
$OpenBSD: patch-docs_man_rotatelogs_8,v 1.5 2011/09/01 13:40:09 giovanni Exp $
|
|
--- docs/man/rotatelogs.8.orig Fri Feb 4 16:20:03 2011
|
|
+++ docs/man/rotatelogs.8 Wed Aug 31 11:58:24 2011
|
|
@@ -19,7 +19,7 @@
|
|
.el .ne 3
|
|
.IP "\\$1" \\$2
|
|
..
|
|
-.TH "ROTATELOGS" 8 "2010-11-06" "Apache HTTP Server" "rotatelogs"
|
|
+.TH "ROTATELOGS2" 8 "2010-11-06" "Apache HTTP Server" "rotatelogs"
|
|
|
|
.SH NAME
|
|
rotatelogs \- Piped logging program to rotate Apache logs
|
|
@@ -27,13 +27,13 @@ rotatelogs \- Piped logging program to rotate Apache l
|
|
.SH "SYNOPSIS"
|
|
|
|
.PP
|
|
-\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBf\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fRM [ \fIoffset\fR ]
|
|
+\fBrotatelogs2\fR [ -\fBl\fR ] [ -\fBf\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fRM [ \fIoffset\fR ]
|
|
|
|
|
|
.SH "SUMMARY"
|
|
|
|
.PP
|
|
-rotatelogs is a simple program for use in conjunction with Apache's piped logfile feature\&. It supports rotation based on a time interval or maximum size of the log\&.
|
|
+rotatelogs2 is a simple program for use in conjunction with Apache's piped logfile feature\&. It supports rotation based on a time interval or maximum size of the log\&.
|
|
|
|
|
|
.SH "OPTIONS"
|
|
@@ -44,7 +44,7 @@ rotatelogs is a simple program for use in conjunction
|
|
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)\&. \fIAvailable in version 2\&.2\&.9 and later\&.\fR
|
|
+Causes the logfile to be opened immediately, as soon as rotatelogs2 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)\&. \fIAvailable in version 2\&.2\&.9 and later\&.\fR
|
|
.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\&. 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 produced and log rotation would keep writing to the same file\&.
|
|
@@ -62,7 +62,7 @@ The number of minutes offset from UTC\&. If omitted, z
|
|
|
|
.nf
|
|
|
|
- CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common
|
|
+ CustomLog "|bin/rotatelogs2 /var/logs/logfile 86400" common
|
|
|
|
.fi
|
|
|
|
@@ -71,7 +71,7 @@ This creates the files /var/logs/logfile\&.nnnn where
|
|
|
|
.nf
|
|
|
|
- CustomLog "|bin/rotatelogs -l /var/logs/logfile\&.%Y\&.%m\&.%d 86400" common
|
|
+ CustomLog "|bin/rotatelogs2 -l /var/logs/logfile\&.%Y\&.%m\&.%d 86400" common
|
|
|
|
.fi
|
|
|
|
@@ -80,7 +80,7 @@ This creates the files /var/logs/logfile\&.yyyy\&.mm\&
|
|
|
|
.nf
|
|
|
|
- CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common
|
|
+ CustomLog "|bin/rotatelogs2 /var/logs/logfile 5M" common
|
|
|
|
.fi
|
|
|
|
@@ -89,7 +89,7 @@ This configuration will rotate the logfile whenever it
|
|
|
|
.nf
|
|
|
|
- ErrorLog "|bin/rotatelogs /var/logs/errorlog\&.%Y-%m-%d-%H_%M_%S 5M"
|
|
+ ErrorLog "|bin/rotatelogs2 /var/logs/errorlog\&.%Y-%m-%d-%H_%M_%S 5M"
|
|
|
|
.fi
|
|
|