---
name: "qsrotate"
section: "1"
platform: "linux"
package: "libapache2-mod-qos"
version: "11.63-1+b2"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/qsrotate"
---

# qsrotate(1)

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

## 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)](/qsexec/1.md), [qsfilter2(1)](/qsfilter2/1.md), [qsgeo(1)](/qsgeo/1.md), [qsgrep(1)](/qsgrep/1.md), qshead(1), [qslog(1)](/qslog/1.md), [qslogger(1)](/qslogger/1.md), [qsre(1)](/qsre/1.md), [qsrespeed(1)](/qsrespeed/1.md), [qspng(1)](/qspng/1.md), [qssign(1)](/qssign/1.md), [qstail(1)](/qstail/1.md)

## AUTHOR

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