1NEWSOUTPUT(8)               System Manager's Manual              NEWSOUTPUT(8)
2
3
4

NAME

6       newsoutput, newsinput - notes/news gateway programs
7

SYNOPSIS

9       newsoutput  [ -a or -ssysname or -c filename ] [ -b ] [ -v ] [ -o date-
10       spec ] [ -f file ] topic [ ... ]
11
12       newsinput [ -t ] [ -1 ]
13

DESCRIPTION

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