rc.news(8)

1RC.NEWS(8)                InterNetNews Documentation                RC.NEWS(8)
2
3
4

NAME

6       rc.news - Start or stop INN daemons
7

SYNOPSIS

9       rc.news [start ⎪ stop]
10

DESCRIPTION

12       rc.news can be used to start or stop innd and supporting programs.  It
13       checks to make sure INN is not already running, handles cases of
14       unclean shutdown, finishes up tasks which might have been interrupted
15       by the preceeding shutdown, emails certain boot-time warnings to news‐
16       master (as set in inn.conf), and is generally safer and easier than
17       starting and stopping everything directly.  It needs to be run as the
18       news user so that files in pathrun are created with the right ownership
19       (though this is less important for "rc.news stop"), and therefore
20       requires that inndstart be setuid root, see inndstart(8) for discus‐
21       sion.
22
23       Programs run and stopped by this script include:
24
25       ·   Always:  inndstart is run, and innd is stopped.
26
27       ·   If doinnwatch is true in inn.conf:  innwatch is started and
28           stopped.
29
30       ·   If docnfsstat is true in inn.conf:  ovdb_init is run; ovdb_server
31           and ovdb_monitor are stopped.
32
33       ·   If rc.news.local exists in pathbin:  rc.news.local is run with
34           argument "start" or "stop" (to perform site-specific startup or
35           shutdown tasks).
36

OPTIONS

38       "start"
39           If the first argument is "start", or no first argument is given,
40           rc.news initiates INN startup.
41
42       "stop"
43           If the first argument is "stop", rc.news initiates INN shutdown.
44           It is recommended to throttle the server first as described in
45           ctlinnd(8).
46

EXAMPLES

48       To start INN and leave certain error messages going to the terminal:
49
50              su - news -c ~news/bin/rc.news
51
52       To run INN at startup time from appropriate system boot scripts:
53
54              su - news -c ~news/bin/rc.news >/dev/console
55
56       To stop INN (throttling first):
57
58              ~news/bin/ctlinnd throttle reason
59              su - news -c '~news/bin/rc.news stop'
60

BUGS

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

HISTORY

67       // FIXME:  any attribution for rc.news itself?
68
69       This manual page written by Jeffrey M. Vinocur <jeff@litech.org> for
70       InterNetNews.
71
72       $Id: rc.news.8 5912 2002-12-03 05:31:11Z vinocur $
73