Provided by: cnews_cr.g7-39_i386
rnews, cunbatch - accept and spool news input
newsspool, newsrun - news input spooler and processing
newsrunning - control news-processing daemon
/usr/lib/news/input/newsspool [ -g grade ] [ file ... ]
/usr/lib/news/input/newsrun [ -s suffixletter ] [ grades ]
Rnews accepts news from standard input and spools it up for processing,
space permitting. If space is persistently too short, rnews looks for
the file /var/lib/news/rnews.stall; if it is present, rnews waits
patiently for more space to appear, while if it is absent, rnews
discards the news and reports this.
Cunbatch is a historical synonym for rnews; there is no difference in
what they do.
Newsspool is the actual spooling program. It copies the input file(s)
(standard input default) to a file in the input-spooling directory
/var/spool/news/in.coming, stripping off any ‘#! cunbatch’ header as it
does so. The filename is based on the current time, plus a suffix
classifying the file by type (compressed or plain text), plus a
possible prefix denoting the one-digit numeric grade (if the -g option
is given; rnews does not use this option).
Newsrun should be run periodically (e.g. by cron(8)) to process spooled
news. Newsrunning can be used to turn newsrun’s processing off and on
if it is desired to avoid major news processing during certain hours.
‘newsrunning off’ instructs any currently-running newsrun to stop as
soon as possible, and prevents later ones from running. (This is a
slight oversimplification; see the discussion of grades below.)
‘newsrunning on’ removes the inhibition (but does not actually start a
new newsrun). Without an argument, newsrunning reports the current
status: ‘‘off’’ or ‘‘on’’.
Newsrun checks for the stop file that newsrunning off creates, verifies
that there is enough disk space for processing, and then starts
processing spooled news. News is processed in order by grade: if the
name of the spooled file starts with a digit followed by a period, the
digit is the file’s grade. Files without a grade are considered to
have a grade just after grade 9. Lower-numbered grades are processed
first, with processing within a grade in chronological order.
If newsrun is invoked with a grades argument, that specifies the grades
to be processed. A grades argument can be a single grade (‘1’), a list
(‘123’), or a range (‘1-5’). In the absence of the argument, newsrun’s
default is all grades if there is no stop file present, and just grade
0 if there is a stop file. If a stop file appears during processing,
newsrun will stop processing all but grade 0 and will exit when there
is no grade-0 news left.
If newsrun is run with a -s option, that restricts processing to files
that end with .suffixletter only. For example, -s t would restrict
processing to files classified as text only (i.e., no processing of
compressed files or unclassified files).
Each batch is decompressed (if necessary) and then fed to relaynews.
(Files that lack a classification suffix, typically because they
arrived by some means other than newsspool, are tried first as
compressed and then as plain text.) If relaynews fails, newsrun
attempts to save the spooled batch in the bad subdirectory for human
(All in /var/spool/news/in.coming)
000000000 (etc.) unclassified ungraded spooled news
000000000.Zungraded compressed spooled news
000000000.tungraded plain-text spooled news
1.000000000.Zgrade 1 compressed spooled news, etc.
stop newsrun disable file
bad directory for failed news
compress(1), newsbatch(8CN), newsmail(8CN), relaynews(8CN)
Complaints are mailed via report if something goes wrong.
Part of C News. Written at University of Toronto by Henry Spencer.
Relaynews is a bit too enthusiastic about declaring batches bad, so
things may end up in bad for no terribly good reason. Actually, it’s
rare for the contents of bad to be very interesting.
The grading mechanism relies slightly on collating sequence, and in
particular on ‘.’ collating before the digits.
18 Sept 1994 RNEWS(8cn)