rotatelogs - 滚动Apache日志的管道日志程序

rotatelogs是一个配合Apache管道日志功能使用的简单程序。举例：

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

此配置会建立文件"/var/logs/logfile.nnnn"，其中的nnnn是名义上的日志启动时的系统时间(此时间总是滚动时间的倍数，可以用于cron脚本的同步)。在滚动时间到达时(在此例中是24小时以后)，会产生一个新的日志。

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

此配置会在日志文件大小增长到5兆字节时滚动该日志。

     ErrorLog "|bin/rotatelogs /var/logs/errorlog.%Y-%m-%d-%H_%M_%S 5M"

此配置会在错误日志大小增长到5兆字节时滚动该日志，日志文件名后缀会按照如下格式创建：errorlog.YYYY-mm-dd-HH_MM_SS 。

语法

**rotatelogs** [ -**l** ] logfile [ rotationtime [ offset ]] | [ filesizeM ]

选项

-l

使用本地时间代替GMT时间作为时间基准。注意：在一个改变GMT偏移量(比如夏令时)的环境中使用-l会导致不可预料的结果。

logfile

它加上基准名就是日志文件名。如果logfile中包含"%"，则它会被视为用于strftime()的格式字符串；否则它会被自动加上以秒为单位的".nnnnnnnnnn"后缀。这两种格式都表示新的日志开始使用的时间。

rotationtime

日志文件滚动的以秒为单位的间隔时间。

offset

相对于UTC的时差的分钟数。如果省略，则假定为"0"并使用UTC时间。比如，要指定UTC时差为"-5小时"的地区的当地时间，则此参数应为"-300"。

filesizeM

指定以filesizeM文件大小滚动，而不是按照时间或时差滚动。

可移植性

下列日志文件格式字符串可以为所有的strftime()实现所支持，见各种扩展库对应的strftime()的手册。

| %A | 星期名全称(本地的) | | %a | 3个字符的星期名(本地的) | | %B | 月份名的全称(本地的) | | %b | 3个字符的月份名(本地的) | | %c | 日期和时间(本地的) | | %d | 2位数的一个月中的日期数 | | %H | 2位数的小时数(24小时制) | | %I | 2位数的小时数(12小时制) | | %j | 3位数的一年中的日期数 | | %M | 2位数的分钟数 | | %m | 2位数的月份数 | | %p | am/pm12小时制的上下午(本地的) | | %S | 2位数的秒数 | | %U | 2位数的一年中的星期数(星期天为一周的第一天) | | %W | 2位数的一年中的星期数(星期一为一周的第一天) | | %w | 1位数的星期几(星期天为一周的第一天) | | %X | 时间(本地的) | | %x | 日期(本地的) | | %Y | 4位数的年份 | | %y | 2位数的年份 | | %Z | 时区名 | | %% | 符号"%"本身 |