innxmit - send Usenet articles to a remote NNTP server
innxmit [ -a ] [ -c ] [ -d ] [ -l ] [ -P portnum ] [ -p ] [ -r ] [ -s ] [ -T timeout ] [
-t timeout ] host file
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 specifying the ``Wnm'' flags in the news-
feeds(5) file. Each line in the batchfile should be in one of the following formats:
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 sepa-
rated 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.
-a If all articles were sent successfully, innxmit will remove the batchfile, other-
wise 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 communica-
tion 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 arti-
cles 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
-l The ``-l'' flag is used to turn off logging of reasons the remote gives for reject-
ing 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 arti-
cle 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 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.
Written by Rich $alz <email@example.com> for InterNetNews. This is revision 126.96.36.199,
ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), shlock(1).