[prev in list] [next in list] [prev in thread] [next in thread]
List: apache-cvs
Subject: svn commit: r1905209 - /httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml
From: covener () apache ! org
Date: 2022-11-09 21:12:59
Message-ID: 20221109211300.091C617AC8B () svn01-us-east ! apache ! org
[Download RAW message or body]
Author: covener
Date: Wed Nov 9 21:12:59 2022
New Revision: 1905209
URL: http://svn.apache.org/viewvc?rev=1905209&view=rev
Log:
add an example where the filename doesnt change
also expand on conditions that authors of post-rotation programs might need to know
Modified:
httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml
Modified: httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml?rev=1905209&r1=1905208&r2=1905209&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml Wed Nov 9 21:12:59 2022
@@ -72,15 +72,22 @@ which is the <directive module="core">Se
<dt><code>-p</code> <var>program</var></dt>
-<dd>If given, <code>rotatelogs</code> will execute the specified
+<dd><p>If given, <code>rotatelogs</code> will execute the specified
program every time a new log file is opened. The filename of the
newly opened file is passed as the first argument to the program. If
executing after a rotation, the old log file is passed as the second
-argument. <code>rotatelogs</code> does not wait for the specified
+argument.</p>
+<p> <code>rotatelogs</code> does not wait for the specified
program to terminate before continuing to operate, and will not log
-any error code returned on termination. The spawned program uses the
+any error code returned on termination.</p>
+<p>The spawned program uses the
same stdin, stdout, and stderr as rotatelogs itself, and also inherits
-the environment.</dd>
+the environment.</p>
+<p>When two parameters are provided, under some conditions the parameters
+will have the same value. For example, if rotation is triggerd but the
+portions of the time and date incorporated into the log filename do not change
+across the rotation.</p>
+</dd>
<dt><code>-f</code></dt>
<dd>Causes the logfile to be opened immediately, as soon as
@@ -211,6 +218,20 @@ an offset.</dd>
<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>
+
+ <example>
+<highlight language="config">
+ CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m 86400" common
+</highlight>
+</example>
+
+ <p>This creates the files /var/log/logfile.yyyy.mm where
+ yyyy is the year and mm is the month. Every day at midnight, rotation
+ will occur, including running programs specified with <code>-p</code>.
+ Despite rotation ocurring, the filename will only change on the first
+ rotation of the month. Rotation on other days will continue to output file
+ and append to it.
+ </p>
<example>
<highlight language="config">
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic