# 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` | 時區名 | | `%%` | 符號"%"本身 |