# Manual Page: rotatelogs

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

    SYNOPSIS
         rotatelogs logfile [rotationtime [offset]] | [filesizeM]

    DESCRIPTION
         rotatelogs is a simple program for use in  conjunction  with
         Apache's piped logfile feature, which can be used like this:

         CustomLog "|bin/rotatelogs /var/logs/logfile 86400" common

         or

         CustomLog "|bin/rotatelogs /var/logs/logfile 5M" common

         This creates the files /var/logs/logfile.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 scripts with it).  At the end of each rota-
         tion time (here after 24 hours) a new log is started.

    OPTIONS
         logfile
              The path plus basename  of  the  logfile.   If  logfile
              includes  any  Otherwise,  the  suffix  .nnnnnnnnnn  is
              automatically added and is the time in  seconds.   Both
              formats  compute  the  start time from the beginning of
              the current period.

         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.

              or

         filesizeM
              The maximum file size  in  megabytes followed  by  the
              letter 'M' to specify size rather than time.  Use this
              parameter in place of both rotationtime and offset.

    PORTABILITY
         The following logfile format string substitutions should  be
         supported   by  all  strftime(3)  implementations,  see  the
         strftime(3) man page for library-specific extensions.

         %A   full weekday name (localized)

         %a   3-character weekday name (localized)

         %B   full month name (localized)

         %b   3-character month name (localized)

         %c   date and time (localized)

         %d   2-digit day of month

         %H   2-digit hour (24 hour clock)

         %I   2-digit hour (12 hour clock)

         %j   3-digit day of year

         %M   2-digit minute

         %m   2-digit month

         %p   am/pm of 12 hour clock (localized)

         %S   2-digit second

         %U   2-digit week of year (Sunday first day of week)

         %W   2-digit week of year (Monday first day of week)

         %w   1-digit weekday (Sunday first day of week)

         %X   time (localized)

         %x   date (localized)

         %Y   4-digit year

         %y   2-digit year

         %Z   time zone name

         %%   literal `%'

    SEE ALSO
         httpd(8)