# 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` | 时区名 | | `%%` | 符号"%"本身 |