Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
INNXMIT(8)		  InterNetNews Documentation		    INNXMIT(8)

NAME
       innxmit - Send Usenet articles to a remote NNTP server

SYNOPSIS
       innxmit [-acdHlprsv] [-P	portnum] [-T seconds] [-t seconds] 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 batch file named file.  It is normally invoked by	a script run
       out of cron(8) that uses	shlock to lock the host	name, followed by a
       ctlinnd command to flush	the batch file.	 If file is not	an absolute
       path name, it is	taken relative to the directory	specified by the
       pathoutgoing parameter in inn.conf.  It is normally written by
       specifying the "Wnm" flags in the newsfeeds file.  Each line in the
       batch file should be in one of the following formats:

	   article Message-ID
	   article

       The first field is either the storage API token of an article or	the
       name of a file holding an article.  If it is not	an absolute pathname
       or a storage API	token, it is taken to be a file	name relative to
       patharticles in inn.conf. If the	second field is	not specified, the
       message-ID will be obtained by scanning the article.  The two fields,
       if present, 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.

       An alternative to innxmit can be	innduct, mentioned in the innfeed(8)
       man page.

OPTIONS
       -a  If all articles were	sent successfully, innxmit will	remove the
	   batch file; 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 batch file to grow excessively
	   large if many articles have been expired and	there are
	   communication problems.  To always rewrite the batch	file, 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 the Bytes: header is also
	   included even if it does not	exist in the original article.	The -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 batch
	   file	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.  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. Converted
       to POD by Julien	Elie.

       $Id: innxmit.pod	9588 2013-12-19	17:46:41Z iulius $

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

INN 2.6.1			  2015-09-12			    INNXMIT(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | HISTORY | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=innxmit&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help