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 preceding shutdown, e-mails certain boot-time warnings to
16       newsmaster (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").
20
21       Programs run and stopped by this script include:
22
23       •   Always:  innd is started or stopped.
24
25       •   If doinnwatch is true in inn.conf:  innwatch is started and
26           stopped.
27
28       •   If docnfsstat is true in inn.conf:  cnfsstat is started and
29           stopped.
30
31       •   If ovmethod is set to "ovdb" in inn.conf:  ovdb_init is run;
32           ovdb_server and ovdb_monitor are stopped.
33
34       •   If rc.news.local exists in pathbin:  rc.news.local is run with
35           argument "start" or "stop" (to perform site-specific startup or
36           shutdown tasks).
37
38       •   When started, if INN appears to have previously been shut down
39           during its expiry process, run expirerm if there are articles to
40           unlink.
41
42       •   When started, if overview data appears to have just been rebuilt
43           and active needs to be renumbered, then actually renumber it.
44

OPTIONS

46       "start"
47           If the first argument is "start", or no first argument is given,
48           rc.news initiates INN startup.
49
50       "stop"
51           If the first argument is "stop", rc.news initiates INN shutdown.
52

EXAMPLES

54       To start INN and leave certain error messages going to the terminal:
55
56              su news -s /bin/sh -c <pathbin in inn.conf>/rc.news
57
58       To run INN at startup time from appropriate system boot scripts:
59
60              su news -s /bin/sh -c <pathbin>/rc.news >> <pathlog>/rc.news 2>&1
61
62       To stop INN:
63
64              su news -s /bin/sh -c '<pathbin>/rc.news stop'
65

BUGS

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

HISTORY

72       // FIXME:  any attribution for rc.news itself?
73
74       This manual page written by Jeffrey M. Vinocur <jeff@litech.org> for
75       InterNetNews.
76