.\" -*- 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 "RC.NEWS 8"
.TH RC.NEWS 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
rc.news \- Start or stop INN daemons
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBrc.news\fR [\f(CW\*(C`start\*(C'\fR | \f(CW\*(C`stop\*(C'\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBrc.news\fR can be used to start or stop \fBinnd\fR and supporting programs.
It checks to make sure INN is not already running, handles cases of
unclean shutdown, finishes up tasks which might have been interrupted by
the preceding shutdown, e\-mails certain boot-time warnings to
\&\fInewsmaster\fR (as set in \fIinn.conf\fR), and is generally safer and easier
than starting and stopping everything directly.  It needs to be run as the
news user so that files in \fIpathrun\fR are created with the right ownership
(though this is less important for \f(CW\*(C`rc.news stop\*(C'\fR).
.PP
Programs run and stopped by this script include:
.IP \(bu 4
Always: \fBinnd\fR is started or stopped.
.IP \(bu 4
If \fIdoinnwatch\fR is true in \fIinn.conf\fR: \fBinnwatch\fR is started and
stopped.
.IP \(bu 4
If \fIdocnfsstat\fR is true in \fIinn.conf\fR: \fBcnfsstat\fR is started and stopped.
.IP \(bu 4
If \fIovmethod\fR is set to \f(CW\*(C`ovdb\*(C'\fR in \fIinn.conf\fR: \fBovdb_init\fR is run;
\&\fBovdb_server\fR and \fBovdb_monitor\fR are stopped.
.IP \(bu 4
If \fIovmethod\fR is set to \f(CW\*(C`ovsqlite\*(C'\fR in \fIinn.conf\fR: \fBovsqlite-server\fR
is started and stopped.
.IP \(bu 4
If \fIrc.news.local\fR exists in \fIpathbin\fR: \fBrc.news.local\fR is run with
argument \f(CW\*(C`start\*(C'\fR or \f(CW\*(C`stop\*(C'\fR (to perform site-specific startup or shutdown
tasks).
.IP \(bu 4
When started, if INN appears to have previously been shut down during
its expiry process, run \fBexpirerm\fR if there are articles to unlink.
.IP \(bu 4
When started, if overview data appears to have just been rebuilt and
\&\fIactive\fR needs to be renumbered, then actually renumber it.
.SH OPTIONS
.IX Header "OPTIONS"
.ie n .IP """start""" 4
.el .IP \f(CWstart\fR 4
.IX Item "start"
If the first argument is \f(CW\*(C`start\*(C'\fR, or no first argument is given,
\&\fBrc.news\fR initiates INN startup.
.ie n .IP """stop""" 4
.el .IP \f(CWstop\fR 4
.IX Item "stop"
If the first argument is \f(CW\*(C`stop\*(C'\fR, \fBrc.news\fR initiates INN shutdown.
.SH EXAMPLES
.IX Header "EXAMPLES"
To start INN and leave certain error messages going to the terminal:
.PP
.Vb 1
\&       su news \-s /bin/sh \-c <pathbin in inn.conf>/rc.news
.Ve
.PP
To run INN at startup time from appropriate system boot scripts:
.PP
.Vb 1
\&       su news \-s /bin/sh \-c <pathbin>/rc.news >> <pathlog>/rc.news 2>&1
.Ve
.PP
To stop INN:
.PP
.Vb 1
\&       su news \-s /bin/sh \-c \*(Aq<pathbin>/rc.news stop\*(Aq
.Ve
.SH HISTORY
.IX Header "HISTORY"
This manual page written by Jeffrey M.\ Vinocur <jeff@litech.org> for
InterNetNews.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
ctlinnd(8), cnfsstat(8), expirerm(8), inn.conf(5), innwatch(8), ovdb(5),
ovsqlite(5).