doc/man/innduct.8

   1 .TH INNDUCT 8
   2 .SH NAME
   3 innduct \- quickly and reliably stream Usenet articles to remote site
   4 .SH SYNOPSIS
   5 .B innduct
   6 .RI [ options ]
   7 .I site
   8 .RI [ fqdn ]
   9 .SH DESCRIPTION
  10 .B innduct
  11 implements NNTP peer-to-peer news transmission including the streaming
  12 extensions, for sending news articles to a remote site.
  13
  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.
  19
  20 By default, innduct reads the default feedfile corresponding to
  21 the site
  22 .I site
  23 (is
  24 .IR pathoutgoing / site )
  25 and feeds it via NNTP, streaming if possible, to the host
  26 .IR fqdn .
  27
  28 If
  29 .I fqdn
  30 is not specified, it defaults to
  31 .IR site .
  32
  33 Logging is sent to syslog.
  34 .SH GENERAL OPTIONS
  35 .TP
  36 .BI \-f feedfile
  37 Specifies
  38 .IR feedfile .
  39 If the specified value ends in a
  40 .B /
  41 it is taken as a directory to use as if it were
  42 .I pathoutgoing
  43 and the actual feed file used is
  44 .IR specified_feedfile / site .
  45 .TP
  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.
  49 .SH TUNING OPTIONS
  50 You should not normally need to adjust these.
  51 .TP
  52 .BI \-\-max-connections= max
  53 Restricts the maximum number of simultaneous NNTP connections used by
  54 for each site to
  55 .IR max .
  56 The default is 10.  There is no global limit on the number of
  57 connections.
  58 .TP
  59 .BI \-\-max-queue-per-conn= max
  60 Restricts the maximum number of outstanding articles queued on any
  61 particular connection
  62 .IR max .
  63 The default is 200.  (Non-streaming connections can only handle one
  64 article at a time.)
  65 .TP
  66 .BI \-\-max-queue-per-conn= max
  67 Restricts the maximum number of outstanding articles queued on any
  68 particular connection
  69 .IR max .
  70 The default is 200.
  71 .SH FILES
  72 .IX Header "FILES"
  73 .IP \fIpathoutgoing\fR/\fIsite\fR
  74 .IX Item "default feedfile"
  75 Default
  76 .IR feedfile .
  77 .IP \fIfeedfile\fR
  78 .IX Item feedfile
  79 Main feed file as specified in
  80 .IR newsfeeds (5).
  81 This and other batchfiles used by innduct contains lines each of which
  82 is of the form
  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
  91 .IX Item "lock file"
  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
 101 remove this file.
 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
 122 .IX Item inn.conf
 123 Used to find
 124 .IR pathoutgoing
 125 if none is specified.
 126 .SH HISTORY
 127 Written by Ian Jackson <ijackson@chiark.greenend.org.uk>
 128 .SH "SEE ALSO"
 129 inn.conf(5),
 130 newsfeeds(5)