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  relative  to  the
       /var/spool/news/out.going 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:

              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, /var/spool/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 contain 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 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 ``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 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.

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

                                                                                       INNXMIT(8)