NAME¶
qsrotate - a log rotation tool (similar to Apache's rotatelogs).
SYNOPSIS¶
qsrotate -o <file> [-s <sec> [-t <hours>]] [-b <bytes>]
[-f] [-z] [-g <num>] [-u <name>] [-m <mask>] [-p] [-d]
DESCRIPTION¶
qsrotate reads from stdin (piped log) and writes the data to the provided file
rotating the file after the specified time.
OPTIONS¶
- -o <file>
- Output log file to write the data to (use an absolute path).
- -s <sec>
- Rotation interval in seconds, default are 86400 seconds.
- -t <hours>
- Offset to UTC (enables also DST support), default is 0.
- -b <bytes>
- File size limitation (default/max. are 2147352576 bytes, min. are 1048576
bytes).
- -f
- Forced log rotation at the specified interval even no data is
written.
- -z
- Compress (gzip) the rotated file.
- -g <num>
- Generations (number of files to keep).
- -u <name>
- Become another user, e.g. www-data. -m <mask> File permission which
is either 600, 640, 660 (default) or 664.
- -p
- Writes data also to stdout (for piped logging). -d Line-by-line data
reading prefixing every line with a timestamp.
EXAMPLE¶
TransferLog "|/usr/bin/qsrotate -f -z -g 3 -o /var/log/apache/access.log
-s 86400"
The name of the rotated file will be /dest/filee.YYYYmmddHHMMSS
where YYYYmmddHHMMSS is the system time at which the data has been
rotated.
NOTE¶
- Each qsrotate instance must use an individual file.
- You may trigger a file rotation manually by sending the signal USR1 to the
process.
SEE ALSO¶
qsdt(1), qsexec(1), qsfilter2(1), qsgeo(1), qsgrep(1), qshead(1), qslog(1),
qslogger(1), qsre(1), qsrespeed(1), qspng(1), qssign(1), qstail(1)
