diff options
Diffstat (limited to 'doc/qsrotate.1.html')
| -rw-r--r-- | doc/qsrotate.1.html | 86 |
1 files changed, 86 insertions, 0 deletions
diff --git a/doc/qsrotate.1.html b/doc/qsrotate.1.html new file mode 100644 index 0000000..faa787a --- /dev/null +++ b/doc/qsrotate.1.html @@ -0,0 +1,86 @@ + +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<HTML><HEAD><TITLE>Man page of QSROTATE</TITLE> +<META name='KeyWords' content='Quality of Service, QoS, Apache Web Server, Web application security, WAF, Open Source Software, Security, Proxy'/> +<META name='author' content='Pascal Buchbinder' /> +</HEAD><BODY> +<H1>QSROTATE</H1> +Section: qsrotate man page (1)<BR>Updated: May 2023<BR><A HREF="#index">Index</A> +<A HREF="index.html#utilities">Return to Main Contents</A><HR> + +<P> +<A NAME="lbAB"> </A> +<H2>NAME</H2> + +qsrotate - a log rotation tool (similar to Apache's rotatelogs). +<A NAME="lbAC"> </A> +<H2>SYNOPSIS</H2> + +qsrotate -o <file> [-s <sec> [-t <hours>]] [-b <bytes>] [-f] [-z] [-g <num>] [-u <name>] [-m <mask>] [-p] [-d] +<A NAME="lbAD"> </A> +<H2>DESCRIPTION</H2> + +qsrotate reads from stdin (piped log) and writes the data to the provided file rotating the file after the specified time. +<A NAME="lbAE"> </A> +<H2>OPTIONS</H2> + +<DL COMPACT> +<DT>-o <file> <DD> +Output log file to write the data to (use an absolute path). +<DT>-s <sec> <DD> +Rotation interval in seconds, default are 86400 seconds. +<DT>-t <hours> <DD> +Offset to UTC (enables also DST support), default is 0. +<DT>-b <bytes> <DD> +File size limitation (default/max. are 2147352576 bytes, min. are 1048576 bytes). +<DT>-f <DD> +Forced log rotation at the specified interval even no data is written. +<DT>-z <DD> +Compress (gzip) the rotated file. +<DT>-g <num> <DD> +Generations (number of files to keep). +<DT>-u <name> <DD> +Become another user, e.g. www-data. -m <mask> +File permission which is either 600, 640, 660 (default) or 664. +<DT>-p <DD> +Writes data also to stdout (for piped logging). -d +Line-by-line data reading prefixing every line with a timestamp. +</DL> +<A NAME="lbAF"> </A> +<H2>EXAMPLE</H2> + +<BR> TransferLog "|/usr/bin/qsrotate -f -z -g 3 -o /var/log/apache/access.log -s 86400" +<P> +The name of the rotated file will be /dest/filee.YYYYmmddHHMMSS where YYYYmmddHHMMSS is the system time at which the data has been rotated. +<A NAME="lbAG"> </A> +<H2>NOTE</H2> + +<BR> - Each qsrotate instance must use an individual file. +<BR> - You may trigger a file rotation manually by sending the signal USR1 +to the process. +<A NAME="lbAH"> </A> +<H2>SEE ALSO</H2> + +<A HREF="qsdt.1.html">qsdt</A>(1), <A HREF="qsexec.1.html">qsexec</A>(1), <A HREF="qsfilter2.1.html">qsfilter2</A>(1), <A HREF="qsgeo.1.html">qsgeo</A>(1), <A HREF="qsgrep.1.html">qsgrep</A>(1), <A HREF="qshead.1.html">qshead</A>(1), <A HREF="qslog.1.html">qslog</A>(1), <A HREF="qslogger.1.html">qslogger</A>(1), <A HREF="qsre.1.html">qsre</A>(1), <A HREF="qsrespeed.1.html">qsrespeed</A>(1), <A HREF="qspng.1.html">qspng</A>(1), <A HREF="qssign.1.html">qssign</A>(1), <A HREF="qstail.1.html">qstail</A>(1) +<A NAME="lbAI"> </A> +<H2>AUTHOR</H2> + +Pascal Buchbinder, <A HREF="http://mod-qos.sourceforge.net/">http://mod-qos.sourceforge.net/</A> +<P> + +<HR> +<A NAME="index"> </A><H2>Index</H2> +<DL> +<DT><A HREF="#lbAB">NAME</A><DD> +<DT><A HREF="#lbAC">SYNOPSIS</A><DD> +<DT><A HREF="#lbAD">DESCRIPTION</A><DD> +<DT><A HREF="#lbAE">OPTIONS</A><DD> +<DT><A HREF="#lbAF">EXAMPLE</A><DD> +<DT><A HREF="#lbAG">NOTE</A><DD> +<DT><A HREF="#lbAH">SEE ALSO</A><DD> +<DT><A HREF="#lbAI">AUTHOR</A><DD> +</DL> +<HR> + +</BODY> +</HTML> |