.\" $Revision: 5909 $
.TH INNXMIT 8
.SH NAME
innxmit \- send Usenet articles to a remote NNTP server
.SH SYNOPSIS
.I innxmit
[
.B \-a
]
[
.B \-c
]
[
.B \-d
]
[
.B \-H
]
[
.B \-l
]
[
.BI \-P " portnum"
]
[
.B \-p
]
[
.B \-r
]
[
.B \-s
]
[
.BI \-T " timeout"
]
[
.BI \-t " timeout"
]
.I host
.I file
.SH DESCRIPTION
.I Innxmit
connects to the NNTP server at the specified
.I host
(validating itself via
.IR passwd.nntp
if possible) 
and sends it the articles specified in the batchfile named
.IR file .
It is normally invoked by a script run out of
.IR cron (8)
that uses
.IR shlock (1)
to lock the host name, followed by a
.IR ctlinnd (8)
command to flush the batchfile.
.PP
If the
.I file
is not an absolute pathname, it is taken relative to the
.I <pathoutgoing in inn.conf>
directory.
It is normally written by specifying the ``Wnm'' flags in the
.I newsfeeds
file.
Each line in the batchfile should be in one of the following formats:
.PP
.RS
.nf
token Message-ID
token
.fi
.RE
.PP
The
.I token
field names the article to be sent.
If the
.I Message-ID
field is not specified, it will be obtained by scanning the article.
The
.I token
and
.I Message-Id
fields are separated by a space.
.PP
If a communication error such as a
.IR write (2)
failure occurs,
.I innxmit
will stop sending and rewrite the batchfile to contain the current
article and any other unsent articles.
.SH OPTIONS
.TP
.B \-a
If all articles were sent successfully,
.I 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 ``\fB\-a\fP'' flag.
.TP
.B \-c
In streaming mode, a check of each message ID is still made to avoid sending
articles already on the server.
The ``\fB\-c\fP'' 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.
.TP
.B \-d
Use the ``\fB\-d\fP'' flag to print debugging information on standard error.
This will show the protocol transactions between
.I innxmit
and the NNTP server on the remote host.
.TP
.B \-H
If the ``\fB\-H\fP'' flag is given, then only headers are sent to
.I host
for all articles except control messages.
And Bytes: header is also included even if it does not exist in the original
article.  ``\fB\-H\fP'' flag is useful for diablo reader.
.TP
.B \-l
The ``\fB\-l\fP'' flag is used to turn on logging of reasons the remote gives
for rejecting an article.
.TP
.B \-P portnum
To specify a port number other than the default, use the ``\fB\-P\fP'' flag.
.TP
.B \-p
If the ``\fB\-p\fP'' 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 ``\fB\-a\fP'' flag.
.TP
.B \-r
If the remote server sends an unexpected reply code,
.I innxmit
will requeue the article and proceed.
Use the ``\fB\-r\fP'' flag if the article should not be requeued.
.TP
.B \-s
.I 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
.I innxmit
will revert to normal NNTP transfer mode.
Use the ``\fB\-s\fP'' flag to disable the attempt to negotiate the streaming
mode extension.
.TP
.B \-T seconds
To specify the total amount of time that should be allowed for article
transfers, use the ``\fB\-T\fP'' flag.
The default is to wait until an I/O error occurs, or all the articles have
been transferred.
If the ``\fB\-T\fP'' flag is used, the time is checked just before each
article is started; it will not abort a transfer that is in progress.
.TP
.B \-t seconds
.I Innxmit
normally blocks until the connection is made.
To specify a timeout on how long to try to make the connection, use 
the ``\fB\-t\fP''
flag.
.TP
.B \-v
Upon exit,
.I innxmit
reports transfer and CPU usage statistics via
.IR syslog (3).
If the ``\fB\-v\fP'' flag is used, they will also be printed on the standard
output.
.SH HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.
.de R$
This is revision \\$3, dated \\$4.
..
.R$ $Id: innxmit.8 5909 2002-12-03 05:17:18Z vinocur $
.SH "SEE ALSO"
ctlinnd(8),
inn.conf(5),
innd(8),
newsfeeds(5),
shlock(1).