rotatelogs(1M)

NAME

rotatelogs - Rotate MSB log files

SYNOPSIS

/usr/vtr/bin/rotatelogs [ -a archive-directory ] [ -b base-log-name ] [ -c ]

[ -d log-directory ] [ -l daemon ] [ -m max-logs ] [ -s log-size ] [ -v ]

DESCRIPTION

The rotatelogs command is used to end the current MSB log file, by default named /usr/vtr/adm/logs/vtrlog, and start a new log. The completed log file is moved to a file named /usr/vtr/adm/logs/vtrlog.backup.1, or the next number in sequence. A series of completed log files will be maintained, by default up to 10, with the oldest being deleted as a new log file is completed.

Typically rotatelogs is run out of cron(1M) each night and is not invoked directly by the user.

rotatelogs has the following options:

-a archive-directory

Defines an archive-directory separate from the log-directory where the backup log files will be stored. The default is identical with the log-directory /usr/vtr/adm/logs.

-b base-log-name

Set the base name of the log file to base-log-name. The default is vtrlog.

-c

Compress the completed log file. gzip(1) is used for the compression. The resulting completed log files will have the form /usr/vtr/adm/logs/vtrlog.backup.*.gz and can be decompressed with gunzip(1).

-d log-directory

Set the directory of the log files to log-directory. The default is /usr/vtr/adm/logs.

-l deamon

Sets which deamon process to notify. The only current value is the default setting of vtrd.

-m max-logs

Maintain up to max-logs completed log files. If more than max-logs completed log files exist, the oldest will be deleted. The default is 10.

-s size

Do not complete the current log file unless it has reached a size of size. The default is 10485760 bytes which is equal to 10 MB.

-v

Run with verbose debugging output. Normally rotatelogs produces no output on sucessful operation.

SEE ALSO

vst(1), vvtr(1), vtrd(1)