innxmit - send Usenet articles to a remote NNTP server
innxmit [ -A alt_spool ] [ -a ] [ -c ] [ -d ] [ -l ] [ -M ] [ -r ] [ -s ]
[ -t timeout ] [ -T timeout ] [ -p ] [ -S ] [ -P portnum ] host file
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 relative to the
<config$_PATH_BATCHDIR> directory (typically /var/news/spool/out.going .)
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
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,
<config$_PATH_SPOOL> (typically /var/news/spool/articles.) 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 contain the current article and
any other unsent articles.
-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''
-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.
-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 communication
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 transliterated 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 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.
-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
-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
-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.
-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.
Written by Rich $alz <email@example.com> for InterNetNews. This is
revision 1.19, dated 1996/12/10.
ctlinnd(8) , innd(8) , newsfeeds(5) , shlock(1) .
You can find a summary and links related to this topic
as part of the Mib Software Usenet RKT.