cyclog(1)

NAME
cyclog - write a log to disk, with automatic rotation

SYNOPSIS
cyclog [ -ssize ] [ -nnum ] [ -mmargin ] dir

DESCRIPTION
cyclog copies its input to a log file in the dir directory. When that file reaches 100000 bytes, cyclog makes sure it is safely written to disk and starts writing to a new file. cyclog also removes old files to guarantee that there are at most 10 log files in dir. The name of a log file is the TAI timestamp when the file was started. The mode of the file is 444 if it has been safely written to disk, 644 otherwise. A log file that has not been written to disk is not guaranteed to survive a system crash. The dir directory must exist and be writable to cyclog.

OPTIONS

-ssize
    (Default: 104000. Minimum: 512.) Maximum file size. After writing this many bytes to one file, cyclog will start a new file.

-nnum
    (Default: 10. Minimum: 1.) Maximum number of log files. If cyclog sees this many files before it opens a new file, it removes the oldest, as determined by the starting timestamps.

-mmargin
    (Default: 4000.) cyclog tries to chop log files at line boundaries. If it sees a newline within margin bytes of the maximum file size, it starts a new file.

SEE ALSO
fsync(2)