.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'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 turned on, 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.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "RC.NEWS 8"
.TH RC.NEWS 8 "2014-03-15" "INN 2.5.4" "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 [start | stop]
.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 \s-1INN\s0 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 \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).
.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 \s-1INN\s0 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 \s-1INN\s0 shutdown.  It
is recommended to throttle the server first as described in \fIctlinnd\fR\|(8).
.SH "EXAMPLES"
.IX Header "EXAMPLES"
To start \s-1INN\s0 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 \s-1INN\s0 at startup time from appropriate system boot scripts:
.PP
.Vb 1
\&       su \- news \-s /bin/sh \-c <pathbin>/rc.news >/dev/console
.Ve
.PP
To stop \s-1INN\s0 (throttling first):
.PP
.Vb 2
\&       <pathbin>/ctlinnd throttle reason
\&       su \- news \-s /bin/sh \-c \*(Aq<pathbin>/rc.news stop\*(Aq
.Ve
.SH "BUGS"
.IX Header "BUGS"
Running \f(CW\*(C`rc.news start\*(C'\fR as root is never the right thing to do, so we
should at minimum check for this and error, or perhaps change effective
user \s-1ID\s0.
.SH "HISTORY"
.IX Header "HISTORY"
// \s-1FIXME:\s0  any attribution for \fIrc.news\fR itself?
.PP
This manual page written by Jeffrey M.\ Vinocur <jeff@litech.org> for
InterNetNews.
.PP
\&\f(CW$Id:\fR rc.news.pod 9599 2014\-02\-08 13:56:54Z iulius $
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIctlinnd\fR\|(8), \fIcnfsstat\fR\|(8), \fIinn.conf\fR\|(5), \fIinnwatch\fR\|(8), \fIovdb\fR\|(5).