1NEWSOUTPUT(8) System Manager's Manual NEWSOUTPUT(8)
2
3
4
6 newsoutput, newsinput - notes/news gateway programs
7
9 newsoutput [ -a or -ssysname or -c filename ] [ -b ] [ -v ] [ -o date-
10 spec ] [ -f file ] topic [ ... ]
11
12 newsinput [ -t ] [ -1 ]
13
15 Newsoutput and newsinput manage the transfer of articles between a
16 notesfile system and a news system.
17
18 Newsoutput gateways notesfile-generated articles to the news system.
19 Several options determine the types of articles to be transfered. The
20 -a option specifies that any notesfile-generated article that has not
21 been in the news system before is to be sent to news. The -ssysname
22 option specifies that only articles from sysname are to be sent to the
23 news system. The -c option directs newsoutput to gateway articles
24 written at any of the systems whose names appear in the file filename.
25 If none of these options is specified, only locally generated articles
26 are sent to the news. In normal operation, the -a or -c options are
27 most typically used; -s is included for backwards compatibility.
28
29 The -b option specifies that newsoutput should generate articles which
30 will be parsed correctly by previous versions of the notesfile/news
31 gateway code. Files containing lists of notesfiles can be specified
32 through the -f option. Use -v for a more verbose output than normal;
33 default operation produces a summary of notes and responses transmitted
34 for each notesfile with traffic.
35
36 The -o option specifies that only articles that arrived on the local
37 system after date-spec are to be considered for transmittal to news.
38 The timestamp file is updated after the execution of newsoutput whether
39 the -o option is specified.
40
41 The actual method of insertion into the news system is determined in
42 the ``net.how'' file by the transmission method for the pseudo-site
43 ``Usenet''. Mappings between notesfiles and newsgroups are specified
44 in the file ``/usr/spool/notes/.utilities/newsgroups''.
45
46 The newsinput program accepts articles from the news system, parses
47 headers, maps newsgroups to appropriate notesfiles, and inserts the
48 articles. News' control messages are intercepted and placed in a main‐
49 tainence notesfile for review by the system manager. When a news arti‐
50 cle maps to a non-existent notesfile, the notesfile is automatically
51 created.
52
53 The -t directs newsinput to NOT log cases where the Message-Id is
54 longer than the reserved space in the note descriptor. These
55 occurences are normally logged in the nfmaint notesfile. The -1 option
56 directs newsinput to place the article in the first notesfile on the
57 Newsgroups line. The normal action is to place a copy of the article
58 in each notesfile specified on the Newsgroups line.
59
60 Typically newsoutput is run by cron(8) at intervals ranging from hourly
61 to daily. Newsinput is invoked automatically by the news system when
62 it propogates articles. See appendix B of The Notesfile Reference Man‐
6