NAME

       rc.news - Start or stop INN daemons

SYNOPSIS

       rc.news [start | stop]

DESCRIPTION

       rc.news can be used to start or stop innd 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 newsmaster (as set in inn.conf), 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
       pathrun are created with the right ownership (though this is less important for "rc.news
       stop").

       Programs run and stopped by this script include:

       •   Always:  innd is started or stopped.

       •   If doinnwatch is true in inn.conf:  innwatch is started and stopped.

       •   If docnfsstat is true in inn.conf:  cnfsstat is started and stopped.

       •   If ovmethod is set to "ovdb" in inn.conf:  ovdb_init is run; ovdb_server and
           ovdb_monitor are stopped.

       •   If rc.news.local exists in pathbin:  rc.news.local is run with argument "start" or
           "stop" (to perform site-specific startup or shutdown tasks).

OPTIONS

       "start"
           If the first argument is "start", or no first argument is given, rc.news initiates INN
           startup.

       "stop"
           If the first argument is "stop", rc.news initiates INN shutdown.  It is recommended to
           throttle the server first as described in ctlinnd(8).

EXAMPLES

       To start INN and leave certain error messages going to the terminal:

              su - news -s /bin/sh -c <pathbin in inn.conf>/rc.news

       To run INN at startup time from appropriate system boot scripts:

              su - news -s /bin/sh -c <pathbin>/rc.news >/dev/console

       To stop INN (throttling first):

              <pathbin>/ctlinnd throttle reason
              su - news -s /bin/sh -c '<pathbin>/rc.news stop'

BUGS

       Running "rc.news start" as root is never the right thing to do, so we should at minimum
       check for this and error, or perhaps change effective user ID.

HISTORY

       // FIXME:  any attribution for rc.news itself?

       This manual page written by Jeffrey M. Vinocur <jeff@litech.org> for InterNetNews.

       $Id: rc.news.pod 9340 2011-08-16 13:50:19Z iulius $

SEE ALSO

       ctlinnd(8), cnfsstat(8), inn.conf(5), innwatch(8), ovdb(5).