SCANLOGS(8) InterNetNews Documentation SCANLOGS(8)NAME
scanlogs - Summarize and rotate INN log files
SYNOPSIS
scanlogs [norotate]
DESCRIPTION
scanlogs summarizes the information recorded in the INN log files which reside in the pathlog directory set in inn.conf (see newslog(5) for
further details about these log files). It is normally invoked by the news.daily(8) script which performs daily server maintenance tasks.
It invokes "ctlinnd flushlogs" to close the news and error log files, rename them to add ".old" to the file names and open fresh news and
error logs; the active file is also flushed to disk, along with the history database.
By default, scanlogs rotates and cleans out the logs. It keeps up to logcycles old compressed log files in pathlog/OLD (the logcycles
parameter can be set in inn.conf). scanlogs also keeps archives of the active file in this directory.
It invokes tally.control if newgroup.log or rmgroup.log exists in pathlog (see the control.log entry of newslog(5) for more information
about that).
scanlogs displays the contents of errlog and news.crit, if non-empty, and runs innreport to summarize the contents of news and news.notice,
and to update the unwanted.log file amongst other things (see more information about that in innreport(8)).
OPTIONS
Only one option is currently accepted:
norotate
Using this option disables the rotating and cleaning aspect of the log processing: the logs files are only scanned for information and
no contents are altered. If scanlogs is invoked more than once a day, the norotate option should be used to prevent premature log
cleaning.
FILES
See newslog(5) for the list of log files processed by scanlogs.
HISTORY
Written by Landon Curt Noll <chongo@toad.com> and Rich $alz <rsalz@uunet.uu.net> for InterNetNews. Converted to POD by Julien Elie.
$Id: scanlogs.pod 8357 2009-02-27 17:56:00Z iulius $
SEE ALSO inn.conf(5), innreport(8), news.daily(8), newslog(5), shlock(1), tally.control(8).
INN 2.5.2 2009-05-21 SCANLOGS(8)
Check Out this Related Man Page
NEWS.DAILY(8) System Manager's Manual NEWS.DAILY(8)NAME
news.daily - do regular Usenet system administration
SYNOPSIS
news.daily [ keyword... ]
DESCRIPTION
News.daily performs a number of important Usenet administrative functions. This includes producing a status report, removing old news
articles, processing log files, rotating the archived log files, renumbering the active file, removing any old socket files found in the
``firewall'' directory, and collecting the output. This program should be run under the news administrator's id, not as root.
By default, news.daily performs all of its functions and mails the output to the news administrator, usenet. By specifying ``keywords'' on
the command line, it is possible to modify the functions performed, as well as change the arguments given to expire(8) and expireover(8).
News.daily should be run once a day, typically out of cron(8). It may be run more often, but such invocations should at least use the
``notdaily'' keyword to prevent the log files from being processed and rotated too fast.
The shlock(1) program is used to prevent simultaneous executions.
KEYWORDS
The following keywords may be used:
delayrm
This uses the ``-z'' flag when invoking expire and expireover. The names of articles to be removed are written to a temporary file,
and then removed after expiration by calling expirerm(8).
expctl=path
Specify the file to use as the expire.ctl(5) file for expire.
expdir=path
By default, expire builds the new history(5) file and database in the same directory as the current files. Using this keyword spec-
ifies a different local to build the new files (by passing the ''-d'' flag to expire), which will then be moved to the right loca-
tion when finished.
nostat This keyword disables the status report generated by innstat (see newslog(8)). Without this keyword, the status report is the first
function performed, just prior to obtaining the news.daily lock.
notdaily
By default news.daily expects to be run only once a day. Use this keyword any extra times news.daily is run in the day and the nor-
mal logfile processing (and rotation) will not be done.
noexpire
By default, expire is invoked to remove old news articles. Using this keyword disables this function.
noexplog
Expire normally appends information to /var/log/news/expire.log (see newslog(5)). Using this keyword causes the expire output to be
handled as part of news.daily's output. It has no effect if the ``noexpire'' keyword is used.
flags='expire args'
By default, expire is invoked with the an argument of ``-v1''. Using this keyword changes the arguments to those specified. Be
careful to use quotes if multiple arguments are needed. This keyword has no effect if the ``noexpire'' keyword is used.
nologs After expiration, scanlogs(8) is invoked to process the log files. Using this keyword disables all log processing functions.
norotate
By default, log processing includes rotating and cleaning out log files. Using this keyword disables the rotating and cleaning
aspect of the log processing: the logs files are only scanned for information and no contents are altered.
This keyword has no effect if the ``nologs'' keyword is used. The ``norotate'' keyword is passed on to scanlogs if it is invoked.
norenumber
This keyword disables the ctlinnd(8) renumber operation. Normally, the low-water mark for all newsgroups (see active(5)) is reset.
norm By default, any socket ctlinnd socket that has not been modified for two days will be removed. Using this keyword disables this
function.
nomail News.daily normally sends a mail message containing the results to the administrator. Using this keyword causes this message to be
sent to stdout and stderr instead. Normally, all utilities invoked by the script have their stdout and stderr redirected into a
file. If the file is empty, no message is sent.
expireover
The expireover program is called after expiration to purge the overview databases.
expireoverflags='expireover args'
If the ``expireover'' keyword is used, this keyword may be used to specify the flags to be passed to expireover. If the ``delayrm''
keyword is used, then the default value is ``-z'' and the list of deleted files; otherwise, the default value is ``-s''.
/full/path
The program specified by the given path is executed just before any expiration is done. A typical use is to specify an alternate
expiration program and use the ``noexpire'' keyword. Multiple programs may be specified; they will be invoked in order.
HISTORY
News.daily and this manual page written by Landon Curt Noll <chongo@toad.com> and Rich $alz <rsalz@uunet.uu.net>. This is revision 1.11,
dated 1996/12/10.
SEE ALSO active(5), ctlinnd(8), expire(8), fastrm(8), newslog(5), newslog(8), innwatch.ctl(5), shlock(1).
NEWS.DAILY(8)