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
INNXMIT(8) System Manager's Manual INNXMIT(8)NAME
innxmit - send Usenet articles to a remote NNTP server
SYNOPSIS
innxmit [ -a ] [ -c ] [ -d ] [ -l ] [ -P portnum ] [ -p ] [ -r ] [ -s ] [ -T timeout ] [ -t timeout ] host file
DESCRIPTION
Innxmit connects to the NNTP server at the specified host (validating itself via passwd.nntp(5) if possible) and sends it the articles
specified in the batchfile named file. It is normally invoked by a script run out of cron(8) that uses shlock(1) to lock the host name,
followed by a ctlinnd(8) command to flush the batchfile.
If the file is not an absolute pathname, it is taken relative to the <pathoutgoing in inn.conf> directory. It is normally written by spec-
ifying the ``Wnm'' flags in the newsfeeds(5) file. Each line in the batchfile should be in one of the following formats:
token Message-ID
token
The token field names the article to be sent. If the Message-ID field is not specified, it will be obtained by scanning the article. The
token and Message-Id fields are separated by a space.
If a communication error such as a write(2) failure occurs, innxmit will stop sending and rewrite the batchfile to contain the current
article and any other unsent articles.
OPTIONS -a If all articles were sent successfully, innxmit will remove the batchfile, otherwise it will rewrite it to contain the list of
unsent articles. If no articles were sent or rejected, the file is left untouched. This can cause the batchfile to grow exces-
sively large if many articles have been expired and there are communication problems. To always rewrite the batchfile, use the
``-a'' flag.
-c In streaming mode a check of each message ID is still made to avoid sending articles already on the server. The ``-c'' flag will,
if streaming mode is supported, result in sending articles without checking. This results in slightly greater throughput and may be
appropriate when it is known that the site could not already have the articles such as in the case of a "leaf" site.
-d Use the ``-d'' flag to print debugging information on standard error. This will show the protocol transactions between innxmit and
the NNTP server on the remote host.
-l The ``-l'' flag is used to turn off logging of reasons the remote gives for rejecting an article.
-P To specify a port number other than the default, use the -P flag.
-p If the ``-p'' flag is given, then no connection is made and the batchfile is purged of entries that refer to files that no longer
exist. This implies the ``-a'' flag.
-r If the remote server sends an unexpected reply code, innxmit will requeue the article and proceed. Use the ``-r'' flag if the arti-
cle should not be requeued.
-s Innxmit will attempt to negotiate a streaming mode extension of the NNTP protocol with the server at connect time. If successful it
will use a slightly different protocol that enhances throughput. If the server does not recognize the streaming mode negotiation
innxmit will revert to normal NNTP transfer mode. Use the ``-s'' flag to disable the attempt to negotiate the streaming mode exten-
sion.
-T To specify the total amount of time that should be allowed for article transfers, use the ``-T'' flag. The default is to wait until
an I/O error occurs, or all the articles have been transferred. If the ``-T'' flag is used, the time is checked just before an
article is started; it will not abort a transfer that is in progress. Both values are measured in seconds.
-t Innxmit normally blocks until the connection is made. To specify a timeout on how long to try to make the connection, use the
``-t'' flag.
-v Upon exit, innxmit reports transfer and CPU usage statistics via syslog(3). If the ``-v'' flag is used, they will also be printed
on the standard output.
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. This is revision 1.8.2.2, dated 2000/08/17.
SEE ALSO ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), shlock(1).
INNXMIT(8)