3 innduct \- quickly and reliably stream Usenet articles to remote site
14 implements NNTP peer-to-peer news transmission including the streaming
15 extensions, for sending news articles to a remote site.
17 One instance of innduct is run for each peer site. innduct manages
18 its interaction with innd so that articles are transmitted quickly,
19 and manages the retransmission its own backlog. innduct includes the
20 locking necessary to avoid multiple simutaneous invocations.
22 By default, innduct reads the default feed file name corresponding to
27 and feeds it vian NNTP, streaming if possible, to the host
32 is not specified, it defaults to
35 Logging is sent to syslog.
39 Specifies the domain name of the host to connect to via NNTP. The
40 default is the site name. The domain name may be specified with
42 or as a 2nd non-option argument, but not both.
45 .IP \fIpathoutgoing\fR/\fIsite\fR
46 .IX Item "default feedfile"
51 Main feed file as specified in
53 This and other batchfiles used by innduct contains lines each of which
55 \& \fItoken\fR \fImessageid\fR
56 where \fItoken\fR is the inn storage API token. Such lines can be
57 written by \fBTf,Wnm\fR in a \fInewsfeeds\fR(5) entry. During
58 processing, innduct overwrites lines in the batch files which
59 correspond to articles it has processed: the line is replaced with
60 one containing only spaces. Only innd should create this file, and
61 only innduct should remove it.
62 .IP \fIfeedfile\fR_lock
64 Lockfile, preventing multiple innduct invocations for the same
65 feed. A process holds this lock after it has opened the lockfile,
66 made an fcntl F_SETLK call, and then checked with stat and fstat that
67 the file it now has open and has locked still has the name
68 \fIfeedfile\fR_lock. (Only) the lockholder may delete the lockfile.
69 .IP \fIfeedfile\fR_flushing
70 .IX Item "flushing file"
71 Batch file: the main feedfile is renamed to this filename by innduct
72 before it asks inn to flush the feed. Only innduct should create or
74 .IP \fIfeedfile\fR_defer
75 .IX Item "flushing file"
76 Batch file containing details of articles whose transmission has
77 recently been deferred at the request of the recipient site. Created,
78 written, read and removed by innduct.
79 .IP \fIfeedfile\fR_defer
81 Batch file containing details of articles whose transmission has
82 recently been deferred at the request of the recipient site. Created,
83 written, read and removed by innduct.
84 .IP \fIfeedfile\fR_backlog.\fItime_t\fR.\fIinum\fR
85 .IX Item "backlog file"
86 Batch file containing details of articles whose transmission has less
87 recently been deferred at the request of the recipient site. Created
88 by innduct, and will also be read and removed by innduct. However the
89 administrator may also safely remove backlog files.
90 .IP \fIfeedfile\fR_backlog\fIsomething\fR
91 .IX Item "manual backlog file"
92 Batch file manually provided by the administrator. The file should be
93 complete and ready to process at the time it is renamed or hardlinked
94 to this name. innduct will then automatically find and read and
95 process it and eventually remove it. The administrator may also
96 safely remove backlog files. \fIsomething\fR should not contain
99 Written by Ian Jackson <ijackson@chiark.greenend.org.uk>