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, fol
lowed by a ctlinnd(8) command to flush the batchfile.
If the file is not an absolute pathname, it is taken rela
tive to the <pathoutgoing in inn.conf> directory. It is
normally written by specifying 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 Mes
sage-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 batch
file 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 excessively 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
transactions between innxmit and the NNTP server on
the remote host.
-l The ``-l'' flag is used to turn off logging of rea
sons 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 article 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 extension.
-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 mea
sured 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 InterNet
News. This is revision 1.8.2.2, dated 2000/08/17.
SEE ALSO
ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), shlock(1).
Man(1) output converted with
man2html