update transforms, 2nd try :-/

.el .ne 3

.IP "\\$1" \\$2

..

.TH "ROTATELOGS" 8 "2010-12-27" "Apache HTTP Server" "rotatelogs"

.TH "ROTATELOGS" 8 "2011-06-22" "Apache HTTP Server" "rotatelogs"

.SH NAME

rotatelogs \- Piped logging program to rotate Apache logs

.SH "SYNOPSIS"

.PP

\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBL\fR \fIlinkname\fR ] [ -\fBf\fR ] [ -\fBv\fR ] [ -\fBe\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fR(B|K|M|G) [ \fIoffset\fR ]

\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBL\fR \fIlinkname\fR ] [ -\fBp\fR \fIprogram\fR ] [ -\fBf\fR ] [ -\fBv\fR ] [ -\fBe\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fR(B|K|M|G) [ \fIoffset\fR ]

.SH "SUMMARY"

-L \fIlinkname\fR

Causes a hard link to be made from the current logfile to the specified link name\&. This can be used to watch the log continuously across rotations using a command like tail -F linkname\&.  

.TP

-p \fIprogram\fR

Causes the specified program to be executed after each rotation\&. Two arguments are supplied upon execution: the newly opened file and the previous file, respectively\&. rotatelogs 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 same stdin, stdout, and stderr as rotatelogs itself, and also inherits the environment\&.  

.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

luaquickhandler	mod/mod_lua.html#luaquickhandler

luaroot	mod/mod_lua.html#luaroot

luascope	mod/mod_lua.html#luascope

maxclients	mod/mpm_common.html#maxclients

maxconnectionsperchild	mod/mpm_common.html#maxconnectionsperchild

maxkeepaliverequests	mod/core.html#maxkeepaliverequests

maxmemfree	mod/mpm_common.html#maxmemfree

maxrequestworkers	mod/mpm_common.html#maxrequestworkers

maxspareservers	mod/prefork.html#maxspareservers

maxsparethreads	mod/mpm_common.html#maxsparethreads

maxthreads	mod/mpm_netware.html#maxthreads

    as swapping increases the latency of each request beyond a point

    that users consider "fast enough". This causes users to hit

    stop and reload, further increasing the load. You can, and

    should, control the <code class="directive"><a href="../mod/mpm_common.html#maxclients">MaxClients</a></code> setting so that your server

    should, control the <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> setting so that your server

    does not spawn so many children it starts swapping. This procedure

    for doing this is simple: determine the size of your average Apache

    process, by looking at your process list via a tool such as

      system.  This is active by default in Apache httpd, but may

      require reconfiguration of your kernel.</li>

      <li>Tune the <code class="directive"><a href="../mod/mpm_common.html#maxclients">MaxClients</a></code> directive to allow

      <li>Tune the <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> directive to allow

      the server to handle the maximum number of simultaneous

      connections without running out of resources.  See also the <a href="perf-tuning.html">performance tuning

      documentation</a>.</li>

        <td>Process ID of current process</td></tr>

<tr><td><code>%...T</code></td>

        <td>Thread ID of current thread</td></tr>

<tr class="odd"><td><code>%...t</code></td>

<tr class="odd"><td><code>%...{g}T</code></td>

        <td>System unique thread ID of current thread (the same ID as

            displayed by e.g. <code>top</code>; currently Linux only)</td></tr>

<tr><td><code>%...t</code></td>

        <td>The current time</td></tr>

<tr><td><code>%...{u}t</code></td>

<tr class="odd"><td><code>%...{u}t</code></td>

        <td>The current time including micro-seconds</td></tr>

<tr class="odd"><td><code>%...{cu}t</code></td>

<tr><td><code>%...{cu}t</code></td>

        <td>The current time in compact ISO 8601 format, including

            micro-seconds</td></tr>

<tr><td><code>%...v</code></td>

<tr class="odd"><td><code>%...v</code></td>

        <td>The canonical <code class="directive"><a href="#servername">ServerName</a></code>

            of the current server.</td></tr>

<tr class="odd"><td><code>%...V</code></td>

<tr><td><code>%...V</code></td>

        <td>The server name of the server serving the request according to the

            <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>

            setting.</td></tr>

<tr><td><code>\&nbsp;</code> (backslash space)</td>

<tr class="odd"><td><code>\&nbsp;</code> (backslash space)</td>

        <td>Non-field delimiting space</td></tr>

<tr class="odd"><td><code>%&nbsp;</code> (percent space)</td>

<tr><td><code>%&nbsp;</code> (percent space)</td>

        <td>Field delimiter (no output)</td></tr>

</table>