Manual Reference Pages - RELAYNEWS (8)
relaynews - store and forward netnews articles
Relaynews installs locally
broadcasts (network) news articles
read from its standard input.
Typically the articles will be in a batch
not be compressed
Articles are usually
queued for transmission to ones netnews neighbours via
and thence via
-d turns on debugging of
-h prevents generation of history entries for rejected articles;
the default behaviour
generates larger history files that allow NNTP
receivers to more efficiently reject offered articles.
-s makes discarding an article a serious matter,
justifying a non-zero exit status (for the benefit of
-c is an optimisation:
currdir is assumed to be the current directory;
in the absence of this option,
pwd is invoked.
any filename arguments after successful processing;
they are assumed to be relative to
pwd if none).
-o causes articles with dates
days old to be dropped
(usually to stop accidentally-retransmitted old articles).
-n causes the current time (as decimal ASCII) to be written into
notefile (which should be an absolute pathname) once if
relaynews finds it necessary to use symbolic links when filing articles.
-x prevents generation of
Xref: headers in articles filed in exactly one newsgroup;
use of this option will interfere with generation of
news overview data
received directly from
xrefsite under the groups and article numbers
found in incoming
-b provides the basis for a news mirroring facility.
-a similarly causes
active to not be updated
received directly from
dupsite to be accepted,
but filed under the filenames found in their
It may be used to recover a news spool,
Control messages, recognised by their
are filed under the
control pseudo-group only,
but are forwarded as usual,
by examining their
Note that posting to the
will not cause a message to be treated as a control message;
control is not a real newsgroup.
An article which contains an
Also-Control: header is treated normally
except that the contents of the header
are executed as if they were the contents of a
Such an article is a form of
hybrid message since it functions as an ordinary article
yet also causes control functions to be executed.
Supersedes: header is a special case
and is rewritten internally
Articles which contain no locally-known
yet accepted by the local subscription list
are filed exactly once,
and forwarded as usual.
If all newsgroups in the article are refused by
the local subscription list
are refused by an
active file entries,
then the article will be
discarded and not filed in
need not be permitted by the local subscription list
but are otherwise processed normally;
this is for backward compatibility
and perhaps to keep the local subscription list short
by not requiring
general and the like to be named.
relaynews -uc /var/news/in.coming -o 7 nntp.* >>/var/lib/news/log 2>>/var/lib/news/errlog"
File and forward articles in batches that arrived by NNTP,
and remove each batch upon successfully processing it.
Discard any articles more than a week old.
netnews article tree
example newsgroup directory
comp.unix.wizards); such directories and their ancestor directories will be
created automatically as needed
example article file name
I flags batch file name
not be automatically created as needed)
determines who receives broadcast netnews articles,
how they are to be sent articles
contains locally-legal newsgroups and (un)moderated flag
record of articles received
and mapping of message-ids to file names
history by message-ids
contains news systems site name,
overriding any other host names
conventional log of incoming articles
conventional log of errors,
should be empty
article headers of the last
consumed to generate overview data
system-specific directory of programs to
/usr/local/libexec/cnews and its subdirectories
directory of programs to implement control messages
the lean, mean news-relayin machine
generates a return address from article headers
newsreply to use the Path header rather than the From header for the return address
ARPA Internet RFCs 1036 and 850
Usually found in
Relaynewss exit status is 0 for successful completion,
1 if at least one batch was bad and worth manual inspection,
2 if the news system needs human attention.
relaynews cannot establish safe
standard file descriptors
standardise its environment
probably due to failure of
it will exit with status of 1
and without writing any complaints on standard error
errlog), as a (possibly-obsolete) security precaution.
Written by Geoff Collyer
at the University of Toronto
as part of the C news project.
A control message which cannot be filed in the
which cannot be filed in the
junk pseudo-group because
junk is not in the
active file will generate an error message
which refers to the groups in its
Newsgroups: header instead of referring to the
Relaynews could run faster in some circumstances
and would be simpler
Control: were required to be the first header,
Newsgroups: were required to be the next.
The whole control message and hybrid message situation
is a festering bug.
Either control messages should be eliminated,
or all forms of backward compatibility should be dropped
Supersedes:) and only
Also-Control: should be supported.
|--> ||RELAYNEWS (8CN) ||10 October 1993 |
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.