innxmit - send Usenet articles to a remote NNTP server


SYNOPSIS

       innxmit  [ -a ] [ -c ] [ -d ] [ -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(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,  fol­
       lowed by a ctlinnd(8) command to flush the batchfile.

       If the file is not an absolute pathname, it is taken rela­
       tive 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 Mes­
       sage-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 batch­
       file 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

              transactions between innxmit and the NNTP server on
              the remote host.

       -l     The ``-l'' flag is used to turn off logging of rea­
              sons 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 mea­
              sured 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.


HISTORY

       Written  by  Rich  $alz <rsalz@uunet.uu.net> for InterNet­
       News.  This is revision 1.8.2.2, dated 2000/08/17.


SEE ALSO

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


Man(1) output converted with man2html