INNXMIT(8)						      System Manager's Manual							INNXMIT(8)

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 speci-
       fying 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 arti-
	      cle 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 exces-
	      sively 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 arti-
	      cle 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 exten-
	      sion.

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