Index for Section 8

Alphabetical listing for I

Bottom of page

INNXMIT(8)
NAME
  innxmit - send Usenet articles to a remote NNTP server

SYNOPSIS
  innxmit [ -a ] [ -c ] [ -d ] [ -H ] [ -l ] [ -P portnum ] [ -p ] [ -r ] [
  -s ] [ -T timeout ] [ -t timeout ] host file

DESCRIPTION
  Innxmit connects to the NNTP server at the specified host (validating
  itself via passwd.nntp 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 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.

OPTIONS
  -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.

  -H   If the ``-H'' flag is given, then only headers are sent to host for
       all articles except control messages.  And Bytes: header is also
       included even if it does not exist in the original article.  ``-H''
       flag is useful for diablo reader.

  -l   The ``-l'' flag is used to turn on logging of reasons the remote gives
       for rejecting an article.

  -P portnum
       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 seconds
       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 each article is
       started; it will not abort a transfer that is in progress.

  -t seconds
       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.

HISTORY
  Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  This is
  revision 5909, dated 2002-12-03.

SEE ALSO
  ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), shlock(1).

Index for Section 8

Alphabetical listing for I

Top of page