1INNXMIT(8) System Manager's Manual INNXMIT(8)
2
6 innxmit - send Usenet articles to a remote NNTP server
7
9 innxmit [ -a ] [ -c ] [ -d ] [ -H ] [ -l ] [ -P portnum ] [ -p ] [ -r ]
10 [ -s ] [ -T timeout ] [ -t timeout ] host file
11
13 Innxmit connects to the NNTP server at the specified host (validating
14 itself via passwd.nntp if possible) and sends it the articles specified
15 in the batchfile named file. It is normally invoked by a script run
16 out of cron(8) that uses shlock(1) to lock the host name, followed by a
17 ctlinnd(8) command to flush the batchfile.
18 If the file is not an absolute pathname, it is taken relative to the
20 <pathoutgoing in inn.conf> directory. It is normally written by speci‐
21 fying the ``Wnm'' flags in the newsfeeds file. Each line in the batch‐
22 file should be in one of the following formats:
23 token Message-ID
25 token
26 The token field names the article to be sent. If the Message-ID field
28 is not specified, it will be obtained by scanning the article. The
29 token and Message-Id fields are separated by a space.
30 If a communication error such as a write(2) failure occurs, innxmit
32 will stop sending and rewrite the batchfile to contain the current
33 article and any other unsent articles.
34
36 -a If all articles were sent successfully, innxmit will remove the
37 batchfile; otherwise it will rewrite it to contain the list of
38 unsent articles. If no articles were sent or rejected, the file
39 is left untouched. This can cause the batchfile to grow exces‐
40 sively large if many articles have been expired and there are
41 communication problems. To always rewrite the batchfile, use
42 the ``-a'' flag.
43 -c In streaming mode, a check of each message ID is still made to
45 avoid sending articles already on the server. The ``-c'' flag
46 will, if streaming mode is supported, result in sending articles
47 without checking. This results in slightly greater throughput
48 and may be appropriate when it is known that the site could not
49 already have the articles such as in the case of a "leaf" site.
50 -d Use the ``-d'' flag to print debugging information on standard
52 error. This will show the protocol transactions between innxmit
53 and the NNTP server on the remote host.
54 -H If the ``-H'' flag is given, then only headers are sent to host
56 for all articles except control messages. And Bytes: header is
57 also included even if it does not exist in the original article.
58 ``-H'' flag is useful for diablo reader.
59 -l The ``-l'' flag is used to turn on logging of reasons the remote
61 gives for rejecting an article.
62 -P portnum
64 To specify a port number other than the default, use the ``-P''
65 flag.
66 -p If the ``-p'' flag is given, then no connection is made and the
68 batchfile is purged of entries that refer to files that no
69 longer exist. This implies the ``-a'' flag.
70 -r If the remote server sends an unexpected reply code, innxmit
72 will requeue the article and proceed. Use the ``-r'' flag if
73 the article should not be requeued.
74 -s Innxmit will attempt to negotiate a streaming mode extension of
76 the NNTP protocol with the server at connect time. If success‐
77 ful it will use a slightly different protocol that enhances
78 throughput. If the server does not recognize the streaming mode
79 negotiation innxmit will revert to normal NNTP transfer mode.
80 Use the ``-s'' flag to disable the attempt to negotiate the
81 streaming mode extension.
82 -T seconds
84 To specify the total amount of time that should be allowed for
85 article transfers, use the ``-T'' flag. The default is to wait
86 until an I/O error occurs, or all the articles have been trans‐
87 ferred. If the ``-T'' flag is used, the time is checked just
88 before each article is started; it will not abort a transfer
89 that is in progress.
90 -t seconds
92 Innxmit normally blocks until the connection is made. To spec‐
93 ify a timeout on how long to try to make the connection, use the
94 ``-t'' flag.
95 -v Upon exit, innxmit reports transfer and CPU usage statistics via
97 syslog(3). If the ``-v'' flag is used, they will also be
98 printed on the standard output.
99
101 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. This is
102 revision 5909, dated 2002-12-03.
103
105 ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), shlock(1).
106 INNXMIT(8)