1INNXMIT(8)                InterNetNews Documentation                INNXMIT(8)
2
3
4

NAME

6       innxmit - Send Usenet articles to a remote NNTP server
7

SYNOPSIS

9       innxmit [-acdHlprsv] [-P portnum] [-T seconds] [-t seconds] host file
10

DESCRIPTION

12       innxmit connects to the NNTP server at the specified host (validating
13       itself via passwd.nntp if possible) and sends it the articles specified
14       in the batch file named file.  It is normally invoked by a script run
15       out of cron(8) that uses shlock to lock the host name, followed by a
16       ctlinnd command to flush the batch file.  If file is not an absolute
17       path name, it is taken relative to the directory specified by the
18       pathoutgoing parameter in inn.conf.  It is normally written by
19       specifying the "Wnm" flags in the newsfeeds file.  Each line in the
20       batch file should be in one of the following formats:
21
22           article Message-ID
23           article
24
25       The first field is either the storage API token of an article or the
26       name of a file holding an article.  If it is not an absolute pathname
27       or a storage API token, it is taken to be a file name relative to
28       patharticles in inn.conf. If the second field is not specified, the
29       message-ID will be obtained by scanning the article.  The two fields,
30       if present, are separated by a space.  If a communication error such as
31       a write(2) failure occurs, innxmit will stop sending and rewrite the
32       batch file to contain the current article and any other unsent
33       articles.
34
35       An alternative to innxmit can be innduct, mentioned in the innfeed(8)
36       man page.
37

OPTIONS

39       -a  If all articles were sent successfully, innxmit will remove the
40           batch file; otherwise it will rewrite it to contain the list of
41           unsent articles.  If no articles were sent or rejected, the file is
42           left untouched.  This can cause the batch file to grow excessively
43           large if many articles have been expired and there are
44           communication problems.  To always rewrite the batch file, use the
45           -a flag.
46
47       -c  In streaming mode, a check of each message-ID is still made to
48           avoid sending articles already on the server.  The -c flag will, if
49           streaming mode is supported, result in sending articles without
50           checking.  This results in slightly greater throughput and may be
51           appropriate when it is known that the site could not already have
52           the articles such as in the case of a "leaf" site.
53
54       -d  Use the -d flag to print debugging information on standard error.
55           This will show the protocol transactions between innxmit and the
56           NNTP server on the remote host.
57
58       -H  If the -H flag is given, then only headers are sent to host for all
59           articles except control messages.  And the Bytes: header is also
60           included even if it does not exist in the original article.  The -H
61           flag is useful for Diablo reader.
62
63       -l  The -l flag is used to turn on logging of reasons the remote gives
64           for rejecting an article.
65
66       -P portnum
67           To specify a port number other than the default, use the -P flag.
68
69       -p  If the -p flag is given, then no connection is made and the batch
70           file is purged of entries that refer to files that no longer exist.
71           This implies the -a flag.
72
73       -r  If the remote server sends an unexpected reply code, innxmit will
74           requeue the article and proceed.  Use the -r flag if the article
75           should not be requeued.
76
77       -s  innxmit will attempt to negotiate a streaming mode extension of the
78           NNTP protocol with the server at connect time.  If successful, it
79           will use a slightly different protocol that enhances throughput.
80           If the server does not recognize the streaming mode negotiation,
81           innxmit will revert to normal NNTP transfer mode.  Use the -s flag
82           to disable the attempt to negotiate the streaming mode extension.
83
84       -T seconds
85           To specify the total amount of time that should be allowed for
86           article transfers, use the -T flag.  The default is to wait until
87           an I/O error occurs, or all the articles have been transferred.  If
88           the -T flag is used, the time is checked just before each article
89           is started; it will not abort a transfer that is in progress.
90
91       -t seconds
92           innxmit normally blocks until the connection is made.  To specify a
93           timeout on how long to try to make the connection, use the -t flag.
94
95       -v  Upon exit, innxmit reports transfer and CPU usage statistics via
96           syslog.  If the -v flag is used, they will also be printed on the
97           standard output.
98

HISTORY

100       Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. Converted
101       to POD by Julien Elie.
102
103       $Id: innxmit.pod 9588 2013-12-19 17:46:41Z iulius $
104

SEE ALSO

106       ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), passwd.nntp(5),
107       shlock(1).
108
109
110
111INN 2.6.4                         2015-09-12                        INNXMIT(8)
Impressum