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.
  64 .TP
  65 .BI \-\-max-queue-per-conn= max
  66 Restricts the maximum number of outstanding articles queued on any
  67 particular connection
  68 .IR max .
  69 The default is 200.
  70 .SH FILES
  71 .IX Header "FILES"
  72 .IP \fIpathoutgoing\fR/\fIsite\fR
  73 .IX Item "default feedfile"
  74 Default
  75 .IR feedfile .
  76 .IP \fIfeedfile\fR
  77 .IX Item feedfile
  78 Main feed file as specified in
  79 .IR newsfeeds (5).
  80 This and other batchfiles used by innduct contains lines each of which
  81 is of the form
  82 \&    \fItoken\fR \fImessageid\fR
  83 where \fItoken\fR is the inn storage API token.  Such lines can be
  84 written by \fBTf,Wnm\fR in a \fInewsfeeds\fR(5) entry.  During
  85 processing, innduct overwrites lines in the batch files which
  86 correspond to articles it has processed: the line is replaced with
  87 one containing only spaces.  Only innd should create this file, and
  88 only innduct should remove it.
  89 .IP \fIfeedfile\fR_lock
  90 .IX Item "lock file"
  91 Lockfile, preventing multiple innduct invocations for the same
  92 feed.  A process holds this lock after it has opened the lockfile,
  93 made an fcntl F_SETLK call, and then checked with stat and fstat that
  94 the file it now has open and has locked still has the name
  95 \fIfeedfile\fR_lock.  (Only) the lockholder may delete the lockfile.
  96 .IP \fIfeedfile\fR_flushing
  97 .IX Item "flushing file"
  98 Batch file: the main feedfile is renamed to this filename by innduct
  99 before it asks inn to flush the feed.  Only innduct should create or
 100 remove this file.
 101 .IP \fIfeedfile\fR_defer
 102 .IX Item "flushing file"
 103 Batch file containing details of articles whose transmission has
 104 recently been deferred at the request of the recipient site.  Created,
 105 written, read and removed by innduct.
 106 .IP \fIfeedfile\fR_backlog.\fItime_t\fR.\fIinum\fR
 107 .IX Item "backlog file"
 108 Batch file containing details of articles whose transmission has less
 109 recently been deferred at the request of the recipient site.  Created
 110 by innduct, and will also be read and removed by innduct.  However the
 111 administrator may also safely remove backlog files.
 112 .IP \fIfeedfile\fR_backlog\fIsomething\fR
 113 .IX Item "manual backlog file"
 114 Batch file manually provided by the administrator.  The file should be
 115 complete and ready to process at the time it is renamed or hardlinked
 116 to this name.  innduct will then automatically find and read and
 117 process it and eventually remove it.  The administrator may also
 118 safely remove backlog files.  \fIsomething\fR may not contain
 119 \fB#\fR \fB~\fR or \fB/\fR.
 120 .IP /etc/news/inn.conf
 121 .IX Item inn.conf
 122 Used to find
 123 .IR pathoutgoing
 124 if none is specified.
 125 .SH HISTORY
 126 Written by Ian Jackson <ijackson@chiark.greenend.org.uk>
 127 .SH "SEE ALSO"
 128 inn.conf(5),
 129 newsfeeds(5)