ROTATELOGS(8)           OpenBSD System Manager's Manual          ROTATELOGS(8)

NAME
     rotatelogs - rotate Apache logs without having to kill the server

SYNOPSIS
     rotatelogs logfile rotationtime [offset]

DESCRIPTION
     rotatelogs is a simple program for use in conjunction with httpd(8)'s
     piped logfile feature which can be used like this:

           TransferLog "| rotatelogs /path/to/logs/access_log 86400"

     This creates the files /path/to/logs/access_log.nnnn where nnnn is the
     system time at which the log nominally starts (this time will always be a
     multiple of the rotation time, so you can synchronize cron(8) scripts
     with it).  At the end of each rotation time (here, after 24 hours), a new
     log is started.

     The arguments are as follows:

     logfile       The path plus basename of the logfile.  If logfile includes
                   any percent characters (`%'), it is treated as a format
                   string for strftime(3).  Otherwise, the suffix .nnnn is au-
                   tomatically added and is the time at which the logfile was
                   created.

     rotationtime  The rotation time in seconds.

     offset        The number of minutes offset from UTC.  If omitted, zero is
                   assumed and UTC is used.  For example, to use local time in
                   the zone UTC -5 hours, specify a value of -300 for this ar-
                   gument.

SEE ALSO
     strftime(3), cron(8), httpd(8), logresolve(8)

OpenBSD 4.7                      May 31, 2007                                1
