1.1 Synopsis and Options

rottlog [options]

--help, -h

Display help page and exit.

--version, -V

Display version, disclaimer, and exit.

--defaults

Display default options that are assumed, even if not explicitly used, and exit.

--showlog logfile, -s logfile

Show contents of archived logfile with default pager. logfile can be an absolute, or relative, filename. If logfile is a relative filename, it will be searched in $packdir directory.

--pager program"

Use program for paging output of showlog. Useful only with --showlog. rottlog relies on system pager variable by default.

--summary logfile

Display a summary of syntax statistics about logfile. It is like --checkrc but more verbose.

--checkrc <rcfile>,<rcfile>,...

Check syntax of specified configuration file(s). <rcfile> must be one, or more, of: daily, weekly, monthly, all.

--force [<daily>] [<weekly>] [<monthly>]

Force rotation and archiving of logfiles, even if unnecessary. This might be useful after adding new entries to a configuration file. If daily, weekly, or monthly is not used, the program will force rotation and archivinig of all entries in all config files. Using --force option will force rotation and archiving of specified config file, and will check for rotation and archiving of remaining config files that follows in time.

--forceonly [<daily>] [<weekly>] [<monthly>]

Like --force but only the specified config file will be forced for rotation and archiving, without check for remaining config files.

--debug, -d

rottlog STDERR verbosity. Please note: if you use this option calling rottlog from your crontab, you will receive a long email containing all the output of rottlog's execution.