Provided by: inn_1.7.2debian-30_i386 bug

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)