NNTPGET(1) General Commands Manual NNTPGET(1)NAME
nntpget - get Usenet articles from a remote NNTP server
SYNOPSIS
nntpget [ -d dist ] [ -f file ] [ -n newsgroups ] [ -t timestring ] [ -o ] [ -u file ] [ -v ] host
DESCRIPTION
Nntpget connects to the NNTP server at the specified host and retrieves articles from it. The Message-ID's of the desired articles are read
from standard input. The articles are sent to standard output.
OPTIONS -o The ``-o'' option may be used only if the command is executed on the host where the innd(8) server is running. If this option is
used, nntpget connects to the specified remote host to retrieve articles. Any article not present in the local history database is
then fetched from the remote site and offered to the local server.
-v If the ``-v'' option is used with the ``-o'' option then the Message-ID of each article will be sent to standard output as it is
processed.
-f The list of article Message-ID's is normally read from standard input. If the ``-f'' option is used, then a ``newnews'' command is
used to retrieve all articles newer then the modification date of the specified file.
-u The ``-u'' option is like ``-f'' except that if the transfer succeedes, the file will be updated with a statistics line, modifying
its timestamp so that it can be used in later invocations.
-t If the ``-t'' option is used, then the specified timestring is used as the time and date parameter to the ``newnews'' command.
-n If either the ``-u'' or ``-f'' options are used, then the ``-n'' option may be used to specify a newsgroup list. The default is
``*''.
-d The ``-d'' option may be used to specify a distribution list when using the ``-u'' or ``-f'' options. The default is no distribu-
tion list.
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. This is revision 5909, dated 2002-12-03.
SEE ALSO innd(8).
NNTPGET(1)
Check Out this Related Man Page
RNEWS(1) General Commands Manual RNEWS(1)NAME
rnews - receive news from a UUCP connection
SYNOPSIS
rnews [ -h host ] [ -N ] [ -P port ] [ -r remote ] [ -S remote ] [ -U ] [ -v ] [ input ]
DESCRIPTION
Rnews reads messages typically queued by a UUCP newsfeed and sends them to the InterNetNews server (either ``localhost'', or the value
defined by the variable <nnrpdposthost in inn.conf>.
The message is read from the specified input file, or standard input if no input is named.
When sent over UUCP, Usenet articles are typically joined in a single batch to reduce the UUCP overhead. Batches can also be compressed,
to reduce the communication time. If a message does not start with a number sign (``#'') and an exclamation point, then the entire input
is taken as a single news article. If it does start with with those two characters, then the first line is read and interpreted as a batch
command.
If the command is ``#! rnews nnn'' where nnn is a number, then the next nnn bytes (starting with the next line) are read as a news article.
If the command is ``#! cunbatch'' then the rest of input is fed to the compress(1) program with the ``-d'' flag to uncompress it, and the
output of this pipe is read as rnews's input. This is for historical compatibility -- there is no program named cunbatch. A compressed
batch will start with a ``#! cunbatch'' line, then contain a series of articles separated by ``#! rnews nnn'' lines. If <DO_RNEWSPROGS in
include/config.h> is defined and the command is any other word, then rnews will try to execute a program with that name in the directory
<pathbin in inn.conf>/bin/rnews.libexec.
The batch will be fed into the program's standard input, and the standard output will be read back as input into rnews. If
<DO_RNEWS_SAVE_BAD in include/config.h> is defined and rnews detects any problems with an article such as a missing header, or an unintel-
ligible reply from the server, it will save a copy of the article in the <pathincoming in inn.conf>/bad directory.
OPTIONS -h If the ``-h'' flag is given, or failing that, the environment variable <_ENV_UUCPHOST in include/paths.h> (typically UU_MACHINE) is
set, then rnews will log the Message-ID and host via syslog(3) for each article offered to the server. Logging will only be done if
the value is not an empty string.
-N Normally, if unpacking the input fails it is re-spooled to <pathincoming in inn.conf> for another attempt later. If the ``-N'' flag
is used then no such re-spooling is done and rnews exits with status value ``9'' to indicate this.
-P If the ``-P'' flag is used, then the articles will be sent to the specified port on the remote host.
-r If the ``-r'' flag is used, then the articles will be sent to the named remote host instead of the default host.
-S ``-S'' flag is equivalent to ``-r'' flag.
-U If the server is not available, the message is spooled into a new file created in the <pathincoming in inn.conf> directory. The
``-U'' flag may be used to send all spooled messages to the server once it becomes available again, and can be invoked regularly by
cron(8).
-v If the ``-v'' flag is used, it will print a notice of all errors on the standard error, naming the input file (if known) and print-
ing the first few characters of the input. Errors are always logged through syslog(3).
BUGS
Rnews cannot process articles that have embedded 's in them.
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. This is revision 1.10.2.1, dated 2000/08/17.
SEE ALSO inn.conf(5), innd(8).
RNEWS(1)