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 automatically 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 argument.

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