Man page of QSROTATE

# QSROTATE

Section: qsrotate man page (1)
Updated: October 2013
Index Return to Main Contents

## NAME

qsrotate - a log rotation tool (similar to Apache's rotatelogs).

## SYNOPSIS

qsrotate -o <file> [-s <sec> [-t <hours>]] [-f] [-z] [-g <num>] [-u <name>] [-p]

## 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 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 are 2147352576 bytes).
-f
  Forced log rotation 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.
-p
  Writes data also to stdout (for piped logging).

## 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!

## 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://opensource.adnovum.ch/mod_qos/

## Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLE
NOTE
SEE ALSO
AUTHOR