1INNXMIT(8) InterNetNews Documentation INNXMIT(8)
2
3
4
6 innxmit - Send Usenet articles to a remote NNTP server
7
9 innxmit [-acdHlprsv] [-P portnum] [-T seconds] [-t seconds] host file
10
12 innxmit connects to the NNTP server at the specified host (validating
13 itself via passwd.nntp if authentication credentials are present for
14 the remote server in that file) and sends it the articles specified in
15 the batch file named file. It is normally invoked by a script run out
16 of cron(8) that uses shlock to lock the host name, followed by a
17 ctlinnd command to flush the batch file. If file is not an absolute
18 path name, it is taken relative to the directory specified by the
19 pathoutgoing parameter in inn.conf. It is normally written by
20 specifying the "Wnm" flags in the newsfeeds file. Each line in the
21 batch file should be in one of the following formats:
22
23 article Message-ID
24 article
25
26 The first field is either the storage API token of an article or the
27 name of a file holding an article. If it is not an absolute pathname
28 or a storage API token, it is taken to be a file name relative to
29 patharticles in inn.conf. If the second field is not specified, the
30 message-ID will be obtained by scanning the article. The two fields,
31 if present, are separated by a space. If a communication error such as
32 a write(2) failure occurs, innxmit will stop sending and rewrite the
33 batch file to contain the current article and any other unsent
34 articles.
35
36 An alternative to innxmit can be innduct, mentioned in the innfeed(8)
37 man page.
38
40 -a If all articles were sent successfully, innxmit will remove the
41 batch file; otherwise it will rewrite it to contain the list of
42 unsent articles. If no articles were sent or rejected, the file is
43 left untouched. This can cause the batch file to grow excessively
44 large if many articles have been expired and there are
45 communication problems. To always rewrite the batch file, use the
46 -a flag.
47
48 -c In streaming mode, a check of each message-ID is made to avoid
49 sending articles already on the remote server. After a certain
50 number of articles accepted in a row, innxmit will no longer send
51 these queries, but will switch back to sending them upon receiving
52 a reject (which may be for another reason than a duplicate, like
53 for instance an unwanted newsgroup).
54
55 The -c flag will, if streaming mode is supported, result in always
56 sending articles without checking. This results in slightly
57 greater throughput and may be appropriate when it is known that the
58 site could not already have the articles such as in the case of a
59 "leaf" site.
60
61 -d Use the -d flag to print debugging information on standard error.
62 This will show the protocol transactions between innxmit and the
63 NNTP server on the remote host.
64
65 -H If the -H flag is given, then only headers are sent to host for all
66 articles except control messages. And the Bytes header field is
67 also included even if it does not exist in the original article.
68 The -H flag is useful for Diablo reader.
69
70 -l The -l flag is used to turn on logging of reasons the remote gives
71 for rejecting an article.
72
73 -P portnum
74 To specify a port number other than the default, use the -P flag.
75
76 -p If the -p flag is given, then no connection is made and the batch
77 file is purged of entries that refer to files that no longer exist.
78 This implies the -a flag.
79
80 -r If the remote server sends an unexpected reply code, innxmit will
81 requeue the article and proceed. Use the -r flag if the article
82 should not be requeued.
83
84 -s innxmit will attempt to negotiate a streaming mode extension of the
85 NNTP protocol with the server at connect time. If successful, it
86 will use a slightly different protocol that enhances throughput.
87 If the server does not recognize the streaming mode negotiation,
88 innxmit will revert to normal NNTP transfer mode. Use the -s flag
89 to disable the attempt to negotiate the streaming mode extension.
90
91 -T seconds
92 To specify the total amount of time that should be allowed for
93 article transfers, use the -T flag. The default is to wait until
94 an I/O error occurs, or all the articles have been transferred. If
95 the -T flag is used, the time is checked just before each article
96 is started; it will not abort a transfer that is in progress.
97
98 -t seconds
99 innxmit normally blocks until the connection is made. To specify a
100 timeout on how long to try to make the connection, use the -t flag.
101
102 -v Upon exit, innxmit reports transfer and CPU usage statistics via
103 syslog. If the -v flag is used, they will also be printed on the
104 standard output.
105
107 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. Converted
108 to POD by Julien Elie.
109
111 ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), passwd.nntp(5),
112 shlock(1).
113
114
115
116INN 2.7.1 2023-03-07 INNXMIT(8)