3 innduct \- quickly and reliably stream Usenet articles to remote site
11 implements NNTP peer-to-peer news transmission including the streaming
12 extensions, for sending news articles to a remote site.
14 You need to run one instance of innduct for each peer site. innduct
15 manages its interaction with innd, including flushing the feed as
16 appropriate, etc., so that articles are transmitted quickly, and
17 manages the retransmission of its own backlog. innduct includes the
18 locking necessary to avoid multiple simutaneous invocations.
20 By default, innduct reads the default feedfile corresponding to
24 .IR pathoutgoing / site )
25 and feeds it via NNTP, streaming if possible, to the host
30 is not specified, it defaults to
33 Logging is sent to syslog.
39 If the specified value ends in a
41 it is taken as a directory to use as if it were
43 and the actual feed file used is
44 .IR specified_feedfile / site .
46 .BR \-q | \-\-quiet-multiple
47 Makes innduct silently exit if another innduct holds the lock for the
48 site. Without \fB-q\fR, this causes a fatal error to be logged.
50 You should not normally need to adjust these.
52 .BI \-\-max-connections= max
53 Restricts the maximum number of simultaneous NNTP connections used by
56 The default is 10. There is no global limit on the number of
59 .BI \-\-max-queue-per-conn= max
60 Restricts the maximum number of outstanding articles queued on any
63 The default is 200. (Non-streaming connections can only handle one
66 .BI \-\-max-queue-per-conn= max
67 Restricts the maximum number of outstanding articles queued on any
73 .IP \fIpathoutgoing\fR/\fIsite\fR
74 .IX Item "default feedfile"
79 Main feed file as specified in
81 This and other batchfiles used by innduct contains lines each of which
83 \& \fItoken\fR \fImessageid\fR
84 where \fItoken\fR is the inn storage API token. Such lines can be
85 written by \fBTf,Wnm\fR in a \fInewsfeeds\fR(5) entry. During
86 processing, innduct overwrites lines in the batch files which
87 correspond to articles it has processed: the line is replaced with
88 one containing only spaces. Only innd should create this file, and
89 only innduct should remove it.
90 .IP \fIfeedfile\fR_lock
92 Lockfile, preventing multiple innduct invocations for the same
93 feed. A process holds this lock after it has opened the lockfile,
94 made an fcntl F_SETLK call, and then checked with stat and fstat that
95 the file it now has open and has locked still has the name
96 \fIfeedfile\fR_lock. (Only) the lockholder may delete the lockfile.
97 .IP \fIfeedfile\fR_flushing
98 .IX Item "flushing file"
99 Batch file: the main feedfile is renamed to this filename by innduct
100 before it asks inn to flush the feed. Only innduct should create or
102 .IP \fIfeedfile\fR_defer
103 .IX Item "flushing file"
104 Batch file containing details of articles whose transmission has
105 recently been deferred at the request of the recipient site. Created,
106 written, read and removed by innduct.
107 .IP \fIfeedfile\fR_backlog.\fItime_t\fR.\fIinum\fR
108 .IX Item "backlog file"
109 Batch file containing details of articles whose transmission has less
110 recently been deferred at the request of the recipient site. Created
111 by innduct, and will also be read and removed by innduct. However the
112 administrator may also safely remove backlog files.
113 .IP \fIfeedfile\fR_backlog\fIsomething\fR
114 .IX Item "manual backlog file"
115 Batch file manually provided by the administrator. The file should be
116 complete and ready to process at the time it is renamed or hardlinked
117 to this name. innduct will then automatically find and read and
118 process it and eventually remove it. The administrator may also
119 safely remove backlog files. \fIsomething\fR may not contain
120 \fB#\fR \fB~\fR or \fB/\fR.
121 .IP /etc/news/inn.conf
125 if none is specified.
127 Written by Ian Jackson <ijackson@chiark.greenend.org.uk>