QSROTATE

Section: qsrotate man page (1)
Updated: May 2023
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 "|/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)  

AUTHOR

Pascal Buchbinder, http://mod-qos.sourceforge.net/


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
NOTE
SEE ALSO
AUTHOR