Table of Contents
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 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.
- -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
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 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 <rsalz@uunet.uu.net> for InterNetNews. This is revision 1.8.2.2, dated
2000/08/17.
ctlinnd(8)
, inn.conf(5)
, innd(8)
, newsfeeds(5)
, shlock(1)
.
Table of Contents