.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "INNWATCH 8"
.TH INNWATCH 8 2024-04-01 "INN 2.7.2" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
innwatch \- Monitor the state of INN and the system
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBinnwatch\fR [\fB\-f\fR \fIctlfile\fR] [\fB\-i\fR \fIseconds\fR] [\fB\-l\fR \fIlogfile\fR]
[\fB\-t\fR \fIseconds\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBinnwatch\fR is normally started and stopped by \fBrc.news\fR when
\&\fIdoinnwatch\fR is set to true in \fIinn.conf\fR.  Every \fIinnwatchsleeptime\fR
seconds, as set in \fIinn.conf\fR as well as other parameters tuning its
behaviour, \fBinnwatch\fR examines the load average, and the number of
free blocks and inodes on the spool partition, as described by its
control file, \fIinnwatch.ctl\fR in \fIpathetc\fR.
.PP
If the load gets too high, or the disk gets too full, it throttles
the server.  When the condition restores, it unblocks the server.
In addition, on each pass through the loop, it will check the logfile
\&\fIpathlog\fR/news.crit to see if it has been modified, and send mail to
the news administrator if so.
.PP
Upon receipt of an interrupt signal (SIGINT), \fBinnwatch\fR will report
its status in the file \fIinnwatch.status\fR in \fIpathrun\fR.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "\fB\-f\fR \fIfile\fR" 4
.IX Item "-f file"
Specify the control file to use, other than the default of
\&\fIinnwatch.ctl\fR in \fIpathetc\fR.
.IP "\fB\-i\fR \fIseconds\fR" 4
.IX Item "-i seconds"
With this option, \fBinnwatch\fR has an initial sleep of \fIseconds\fR
seconds at startup.  This is useful when \fBinnwatch\fR is started at
the same time as INN, so that it can wait a little before beginning
performing its checks.
.IP "\fB\-l\fR \fIlogfile\fR" 4
.IX Item "-l logfile"
Specify a log file to watch, other than the default of \fInews.crit\fR.
.IP "\fB\-t\fR \fIseconds\fR" 4
.IX Item "-t seconds"
Specify the period in seconds between checks, to override the value
set in \fIinn.conf\fR.
.SH HISTORY
.IX Header "HISTORY"
Written by Mike Cooper <mcooper@usc.edu>, with modifications by
<kre@munnari.oz.au>, Steve Groom <stevo@elroy.jpl.nasa.gov> and
Christophe Wolfhugel <wolf@pasteur.fr>.  Converted to POD by Julien Elie.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
inn.conf(5), innwatch.ctl(5), newslog(5), rc.news(8).