QSROTATE
Section: qsrotate man page (1)
Updated: October 2017
Index
Return to Main Contents
 
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 "|qsrotate -f -z -g 3 -o /dest/file -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
qsexec(1), qsfilter2(1), qsgeo(1), qsgrep(1), qshead(1), qslog(1), qslogger(1), qspng(1), qssign(1), qstail(1)
 
AUTHOR
Pascal Buchbinder, http://mod-qos.sourceforge.net/
 Index
- NAME
- 
- SYNOPSIS
- 
- DESCRIPTION
- 
- OPTIONS
- 
- EXAMPLE
- 
- NOTE
- 
- SEE ALSO
- 
- AUTHOR
-