NAME
innxmit - send Usenet articles to a remote NNTP server
SYNOPSIS
innxmit [ -A alt_spool ] [ -a ] [ -c ] [ -d ] [ -l ] [ -M ]
[ -r ] [ -s ] [ -t timeout ] [ -T timeout ] [ -p ] [ -S ] [
-P portnum ] host file
DESCRIPTION
Innxmit connects to the NNTP server at the specified host
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 rela-
tive to the /news/out.going directory. It is normally writ-
ten by specifying the ``Wnm'' flags in the newsfeeds(5)
file. Each line in the batchfile should be in one of the
following formats:
filename Message-ID
filename
The filename field names the article to be sent. If it is
not an absolute pathname it is taken relative to the news
spool directory, /news. If the Message-ID field is not
specified, it will be obtained by scanning the article. The
filename 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 con-
tain the current article and any other unsent articles.
OPTIONS
-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.
-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 arti-
cle is started; it will not abort a transfer that is in
progress. Both values are measured in seconds.
-P To specify a port number other than the default, use
the -P 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.
-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.
-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 com-
munication problems. To always rewrite the batchfile,
use the ``-a'' 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.
-S If the ``-S'' flag is given, then innxmit will offer
articles to the specified host using the ``xreplic''
protocol extension described in innd(8). The ``-S''
flag implies ``-s'', since streaming is not supported
in the xreplic protocol. To use this flag, the input
file must contain the history data (commas are transli-
terated to spaces by the server). In order for this
flag to be used, the input must contain the necessary
history entries. This is usually done by setting up a
``WnR'' entry in the newsfeeds file.
-d Use the ``-d'' flag to print debugging information on
standard error. This will show the protocol transac-
tions 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.
-M If the ``-M'' flag is used then innxmit will scan an
article's headers before sending it. If the article
appears to be a MIME article that is not in seven-bit
format, the article will be sent in ``quoted-
printable'' form.
-A The ``-A'' flag may be used to specify an alternate
spool directory to use if the article is not found;
this would normally be an NFS-mounted spool directory
of a master server with longer expiration times.
-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 negotia-
tion innxmit will revert to normal NNTP transfer mode.
Use the ``-s'' flag to disable the attempt to negotiate
the streaming mode extension.
-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.
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.
This is revision 1.19, dated 1996/12/10.
SEE ALSO
ctlinnd(8), innd(8), newsfeeds(5), shlock(1).
Man(1) output converted with
man2html