1INNFEED.CONF(5)           InterNetNews Documentation           INNFEED.CONF(5)
2
3
4

NAME

6       innfeed.conf - Configuration file for innfeed
7

IN A NUTSHELL

9       The innfeed.conf file configures to which remote peers innfeed sends
10       NNTP feeds.
11
12       A common entry to parameterize "news.server.com" as an outgoing feed
13       is:
14
15           peer news.server.com {
16               ip-name: "news.server.com"
17           }
18
19       If standard NNTP port 119 is not used, you may specify an alternate
20       port as follows:
21
22           peer news.server.com {
23               ip-name: "news.server.com"
24               port-number: 433
25           }
26
27       After any changes, run "inncheck" to perform basic syntax checks, and
28       reload this configuration file with the following command which makes
29       innd respawn a new instance of innfeed (assuming "innfeed!" is the name
30       of the corresponding channel feed in newsfeeds):
31
32           ctlinnd flush innfeed!
33

DESCRIPTION

35       The configuration file innfeed.conf in pathetc is used to control the
36       innfeed(8) program.  It is a fairly free-format file that consists of
37       three types of entries: key:value, peer and group.  Comments are from
38       the hash character "#" to the end of the line.
39
40       key:value entries are a keyword and a value separated by a colon (which
41       can itself be surrounded by whitespace).  For example:
42
43           max-connections: 10
44
45       A legal key starts with a letter and contains only letters, digits, and
46       the "_" and "-" characters.  There are 5 different types of values:
47       integers, floating-point numbers, characters, booleans, and strings.
48
49       Integer and floating-point numbers are as to be expected, except that
50       exponents in floating-point numbers are not supported.  A boolean value
51       is either "true" or "false" (case is not significant).  A character
52       value is a single-quoted character as defined by the C-language.  A
53       string value is any other sequence of characters.  If the string needs
54       to contain whitespace, then it must be quoted with double quotes, and
55       uses the same format for embedding non-printing characters as normal
56       C-language string.
57
58       Peer entries look like:
59
60           peer <name> {
61               # body ...
62           }
63
64       The word "peer" is required.  The <name> is the same as the site name
65       in INN's newsfeeds configuration file.  The body of a peer entry
66       contains some number (possibly zero) of key:value entries.
67
68       Group entries look like:
69
70           group <name> {
71               # body ...
72           }
73
74       The word "group" is required.  The <name> is any string valid as a key.
75       The body of a group entry contains any number of the three types of
76       entries.  So key:value pairs can be defined inside a group, and peers
77       can be nested inside a group, and other groups can be nested inside a
78       group.
79
80       key:value entries that are defined outside of all peer and group
81       entries are said to be at "global scope".  There are global key:value
82       entries that apply to the process as a whole (for example the location
83       of the backlog file directory), and there are global key:value entries
84       that act as defaults for peers.  When innfeed looks for a specific
85       value in a peer entry (for example, the maximum number of connections
86       to set up), if the value is not defined in the peer entry, then the
87       enclosing groups are examined for the entry (starting at the closest
88       enclosing group).  If there are no enclosing groups, or the enclosing
89       groups do not define the key:value, then the value at global scope is
90       used.
91
92       A small example could be:
93
94           # Global value applied to all peers that have
95           # no value of their own.
96           max-connections: 5
97
98           # A peer definition.  "uunet" is the name used by innd
99           # in the newsfeeds configuration file.
100           peer uunet {
101               ip-name: usenet1.uu.net
102           }
103
104           peer vixie {
105               ip-name: gw.home.vix.com
106               max-connections: 10       # Override global value.
107           }
108
109           # A group of two peers which can handle more connections
110           # than normal.
111           group fast-sites {
112               max-connections: 15
113
114               # Another peer.  The "max-connections" value from the
115               # "fast-sites" group scope is used.  The "ip-name" value
116               # defaults to the peer's name.
117               peer data.ramona.vix.com {
118               }
119
120               peer bb.home.vix.com {
121                   max-connections: 20   # He can really cook.
122               }
123           }
124
125       Given the above configuration file, the defined peers would have the
126       following values for the max-connections key:
127
128           uunet                  5
129           vixie                 10
130           data.ramona.vix.com   15
131           bb.home.vix.com       20
132
133       innfeed ignores key:value pairs it is not interested in.  Some
134       configuration file values can be set via a command-line option, in
135       which case that setting overrides the settings in the file.
136
137       Configuration files can be included in other configuration files via
138       the syntax:
139
140           $INCLUDE filename
141
142       There is a maximum nesting depth of 10.
143
144       For a fuller example configuration file, see the supplied innfeed.conf.
145

GLOBAL VALUES

147       The following listing show all the keys that apply to the process as
148       whole.  These are not required (compiled-in defaults are used where
149       needed).
150
151       news-spool
152           This key requires a pathname value and defaults to patharticles in
153           inn.conf.  It specifies where the top of the article spool is.
154           This corresponds to the -a command-line option.
155
156       input-file
157           This key requires a pathname value.  It specifies the pathname
158           (relative to the backlog-directory value) that should be read in
159           funnel-file mode.  This corresponds to giving a filename as an
160           argument on the command-line (i.e. its presence also implies that
161           funnel-file mode should be used).
162
163           The default is unset; innfeed then runs in channel or batch mode.
164
165       pid-file
166           This key requires a pathname value and defaults to innfeed.pid.  It
167           specifies the pathname (relative to pathrun in inn.conf) where the
168           pid of the innfeed process should be stored.  This corresponds to
169           the -p command-line option.
170
171       debug-level
172           This key defines the debug level for the process.  Default is 0.  A
173           non-zero number generates a lot of messages to stderr, or to the
174           config-defined log-file.  This corresponds to the -d command-line
175           option.
176
177           If a file named innfeed.debug exists in the pathlog directory (as
178           set in inn.conf), then debug-level is automatically set to 1.  This
179           is a cheap way of avoiding continual reloading of the newsfeeds
180           file when debugging.  Note that debug messages still go to log-
181           file.
182
183       debug-shrinking
184           This key requires a boolean value and defaults to false (the debug
185           file is allowed to grow without bound).  If set to true, this file
186           is truncated when its size reaches a certain limit.  See backlog-
187           limit for more details.
188
189       initial-sleep
190           This key requires a positive integer.  The default value is 2.  It
191           defines the number of seconds to wait when innfeed (or a fork)
192           starts, before beginning to open connections to remote hosts.
193
194       fast-exit
195           This key requires a boolean value and defaults to false.  If set to
196           true, when innfeed receives a SIGTERM or SIGQUIT signal, it will
197           close its listeners as soon as it can, even if it means dropping
198           articles.
199
200       use-mmap
201           This key requires a boolean value and defaults to true.  When
202           innfeed is given file names to send (a fairly rare use case)
203           instead of storage API tokens, it specifies whether mmaping should
204           be used if innfeed has been built with mmap(2) support.  If article
205           data on disk is not in NNTP-ready format (CR/LF at the end of each
206           line), then after mmaping, the article is read into memory and
207           fixed up, so mmaping has no positive effect (and possibly some
208           negative effect depending on your system), and so in such a case
209           this value should be "false", which corresponds to the -M command-
210           line option.
211
212       log-file
213           This key requires a pathname value and defaults to innfeed.log.  It
214           specifies where any logging messages that could not be sent via
215           syslog(3) should go (such as those generated when a positive value
216           for debug-value is used).  This corresponds to the -l command-line
217           option.
218
219           This pathname is relative to pathlog in inn.conf.
220
221       log-time-format
222           This key requires a format string suitable for strftime(3).  It is
223           used for messages sent via syslog(3) and to the status-file.
224           Default value is "%a %b %d %H:%M:%S %Y".
225
226       backlog-directory
227           This key requires a pathname value and defaults to innfeed.  It
228           specifies where the current innfeed process should store backlog
229           files.  This corresponds to the -b command-line option.
230
231           This pathname is relative to pathspool in inn.conf.
232
233       backlog-highwater
234           This key requires a positive integer value and defaults to 5.  It
235           specifies how many articles should be kept on the backlog file
236           queue before starting to write new entries to disk.
237
238       backlog-ckpt-period
239           This key requires a positive integer value and defaults to 30.  It
240           specifies how many seconds elapse between checkpoints of the input
241           backlog file.  Too small a number will mean frequent disk accesses;
242           too large a number will mean after a crash, innfeed will re-offer
243           more already-processed articles than necessary.
244
245       backlog-newfile-period
246           This key requires a positive integer value and defaults to 600.  It
247           specifies how many seconds elapse before each check for externally
248           generated backlog files that are to be picked up and processed.
249
250       backlog-rotate-period
251           This key requires a positive integer value and defaults to 60.  It
252           specifies how many seconds elapse before innfeed checks for a
253           manually created backlog file and moves the output backlog file to
254           the input backlog file.
255
256       dns-retry
257           This key requires a positive integer value and defaults to 900.  It
258           defines the number of seconds between attempts to re-lookup host
259           information that previously failed to be resolved.
260
261       dns-expire
262           This key requires a positive integer value and defaults to 86400.
263           It defines the number of seconds between refreshes of name to
264           address DNS translation.  This is so long-running processes do not
265           get stuck with stale data, should peer IP addresses change.
266
267       gen-html
268           This key requires a boolean value and defaults to false.  It
269           specifies whether the status-file should be HTML-ified.
270
271       status-file
272           This key requires a pathname value and defaults to innfeed.status.
273           An absolute pathname can be used.  It specifies the pathname
274           (relative to pathhttp when gen-html is true; otherwise, pathlog as
275           set in inn.conf) where the periodic status of the innfeed process
276           should be stored.  This corresponds to the -S command-line option.
277
278       connection-stats
279           This key requires a boolean value and defaults to false.  If the
280           value is true, then whenever the transmission statistics for a peer
281           are logged, each active connection logs its own statistics.  This
282           corresponds to the -z command-line option.
283
284       host-queue-highwater
285           This key requires a positive integer value and defaults to 10.  It
286           defines how many articles will be held internally for a peer before
287           new arrivals cause article information to be spooled to the backlog
288           file.
289
290       stats-period
291           This key requires a positive integer value and defaults to 600.  It
292           defines how many seconds innfeed waits between generating
293           statistics on transfer rates.
294
295       stats-reset
296           This key requires a positive integer value and defaults to 43200.
297           It defines how many seconds innfeed waits before resetting all
298           internal transfer counters back to zero (after logging one final
299           time).  This is so a innfeed process running more than a day will
300           generate "final" stats that will be picked up by logfile processing
301           scripts.
302
303       initial-reconnect-time
304           This key requires a positive integer value and defaults to 30.  It
305           defines how many seconds to first wait before retrying to reconnect
306           after a connection failure.  If the next attempt fails too, then
307           the reconnect time is approximately doubled until the connection
308           succeeds, or max-reconnect-time is reached.
309
310       max-reconnect-time
311           This key requires an integer value and defaults to 3600.  It
312           defines the maximum number of seconds to wait between attempt to
313           reconnect to a peer.  The initial value for reconnection attempts
314           is defined by initial-reconnect-time, and it is doubled after each
315           failure, up to this value.
316
317       stdio-fdmax
318           This key requires a non-negative integer value and defaults to 0.
319           If the value is greater than zero, then whenever a network socket
320           file descriptor is created and it has a value less than this, the
321           file descriptor will be dup'ed to bring the value up greater than
322           this.  This is to leave lower numbered file descriptors free for
323           stdio.  Certain systems, Sun's in particular, require this.  SunOS
324           4.1.x usually requires a value of 128 and Solaris requires a value
325           of 256.  The default if this is not specified, is 0.
326
327   Special keys for imapfeed
328       The following keys are used with imapfeed to authenticate to a remote
329       host.  Several parameters may be included at global scope:
330
331       deliver-authname
332           The authname is who you want to authenticate as.
333
334       deliver-password
335           This is the appropriate password for authname.
336
337       deliver-username
338           The username is who you want to "act" as, that is, who is actually
339           going to be using the server.
340
341       deliver-realm
342           In this case, the "realm" is the realm in which the specified
343           authname is valid.  Currently this is only needed by the DIGEST-MD5
344           SASL mechanism.
345
346       deliver-rcpt-to
347           A printf(3)-style format string for creating the envelope recipient
348           address.  The pattern MUST include a single string specifier which
349           will be replaced with the newgroup (e.g. "bb+%s").  The default is
350           "+%s".
351
352       deliver-to-header
353           An optional printf(3)-style format string for creating a To header
354           field to be prepended to the article.  The pattern MUST include a
355           single string specifier which will be replaced with the newgroup
356           (e.g. "post+%s@domain").  If not specified, the To header field
357           will not be prepended.
358

GLOBAL PEER DEFAULTS

360       All the key:value pairs mentioned in this section can be specified at
361       global scope.  They may also be specified inside a group or peer
362       definition.  Note that when peers are added dynamically (i.e. when
363       innfeed receives an article for an unspecified peer), it will add the
364       peer site using the parameters specified at global scope.
365
366   Required keys
367       No keys are currently required.  They all have a default value, if not
368       present in the configuration file.
369
370   Optional keys
371       The following keys are optional:
372
373       article-timeout
374           This key requires a non-negative integer value.  The default value
375           is 600.  If no articles need to be sent to the peer for this many
376           seconds, then the peer is considered idle and all its active
377           connections are torn down.
378
379       response-timeout
380           This key requires a non-negative integer value.  The default value
381           is 300.  It defines the maximum amount of time to wait for a
382           response from the peer after issuing a command.
383
384       initial-connections
385           This key requires a non-negative integer value.  The default value
386           is 1.  It defines the number of connections to be opened
387           immediately when setting up a peer binding.  A value of 0 means no
388           connections will be created until an article needs to be sent.
389
390       max-connections
391           This key requires a positive integer value.  The default value is 2
392           but may be increased if needed or for large feeds.  It defines the
393           maximum number of connections to run in parallel to the peer.  A
394           value of 0 specifies an unlimited number of maximum connections.
395           In general, use of an unlimited number of maximum connections is
396           not recommended.  Do not ever set max-connections to zero with
397           dynamic-method 0 set, as this will saturate peer hosts with
398           connections.
399
400       close-period
401           This key requires a positive integer value and defaults to 86400.
402           It is the maximum number of seconds a connection should be kept
403           open.  Some NNTP servers do not deal well with connections being
404           held open for long periods.
405
406       dynamic-method
407           This key requires an integer value between 0 and 3.  The default
408           value is 3.  It controls how connections are opened, up to the
409           maximum specified by max-connections.  In general (and
410           specifically, with dynamic-method 0), a new connection is opened
411           when the current number of connections is below max-connections,
412           and an article is to be sent while no current connections are idle.
413           Without further restraint (i.e. using dynamic-method 0), in
414           practice this means that max-connections connections are
415           established while articles are being sent.  Use of other dynamic-
416           method settings imposes a further limit on the amount of
417           connections opened below that specified by max-connections.  This
418           limit is calculated in different ways, depending of the value of
419           dynamic-method.
420
421           Users should note that adding additional connections is not always
422           productive -- just because opening twice as many connections
423           results in a small percentage increase of articles accepted by the
424           remote peer, this may be at considerable resource cost both locally
425           and at the remote site, whereas the remote site might well have
426           received the extra articles sent from another peer a fraction of a
427           second later.  Opening large numbers of connections is considered
428           antisocial.
429
430           The meanings of the various settings are:
431
432           0 (no method)
433             Increase of connections up to max-connections is unrestrained.
434
435           1 (maximize articles per second)
436             Connections are increased (up to max-connections) and decreased
437             so as to maximize the number of articles per second sent, while
438             using the fewest connections to do this.
439
440           2 (set target queue length)
441             Connections are increased (up to max-connections) and decreased
442             so as to keep the queue of articles to be sent within the bounds
443             set by dynamic-backlog-low and dynamic-backlog-high, while using
444             the minimum resources possible.  As the queue will tend to fill
445             if the site is not keeping up, this method ensures that the
446             maximum number of articles are offered to the peer while using
447             the minimum number of connections to achieve this.
448
449           3 (combination)
450             This method uses a combination of methods 1 and 2 above.  For
451             sites accepting a large percentage of articles, method 2 will be
452             used to ensure these sites are offered as complete a feed as
453             possible.  For sites accepting a small percentage of articles,
454             method 1 is used, to minimize remote resource usage.  For
455             intermediate sites, an appropriate combination is used.
456
457       dynamic-backlog-low
458           This key requires a floating-point value between 0 and 100.  It
459           represents (as a percentage) the low water mark for the host queue.
460           If the host queue falls below this level while using dynamic-method
461           2 or 3, and if 2 or more connections are open, innfeed will attempt
462           to drop connections to the host.  An Infinite Impulse Response
463           (IIR) filter is applied to the value to prevent connection flap
464           (see dynamic-filter).  The default value is 20.0.  This value must
465           be smaller than dynamic-backlog-high.
466
467       dynamic-backlog-high
468           This key requires a floating-point value between 0 and 100.  It
469           represents (as a percentage) the high water mark for the host
470           queue.  If the host queue rises above this level while using
471           dynamic-method 2 or 3, and if less than max-connections are open to
472           the host, innfeed will attempt to open further connections to the
473           host.  An Infinite Impulse Response (IIR) filter is applied to the
474           value to prevent connection flap (see dynamic-filter).  The default
475           value is 50.0.  This value must be larger than dynamic-backlog-low.
476
477       dynamic-backlog-filter
478           This key requires a floating-point value between 0 and 1.  It
479           represents the filter coefficient used by the Infinite Impulse
480           Response (IIR) filter used to implement dynamic-method 2 and 3.
481           The default value of this filter is 0.7, giving a time constant of
482           1/(1-0.7) articles.  Higher values will result in slower response
483           to queue fullness changes; lower values in faster response.
484
485       max-queue-size
486           This key requires a positive integer value.  The default value is
487           20.  It defines the maximum number of articles to process at one
488           time when using streaming to transmit to a peer.  Larger numbers
489           mean more memory consumed as articles usually get pulled into
490           memory (see the description of use-mmap).
491
492       streaming
493           This key requires a boolean value.  Its default value is true.  It
494           defines whether streaming commands are used to transmit articles to
495           the peers.
496
497       no-check-high
498           This key requires a floating-point number which must be in the
499           range [0.0, 100.0].  When running transmitting with the streaming
500           commands, innfeed attempts an optimization called "no-CHECK mode".
501           This involves not asking the peer if it wants the article, but just
502           sending it.  This optimization occurs when the percentage of the
503           articles the peer has accepted gets larger than this number.  If
504           this value is set to 100.0, then this effectively turns off no-
505           CHECK mode, as the percentage can never get above 100.0.  If this
506           value is too small, then the number of articles the peer rejects
507           will get bigger (and your bandwidth will be wasted).  The default
508           value of 95.0 usually works pretty well.
509
510       no-check-low
511           This key requires a floating-point number which must be in the
512           range [0.0, 100.0], and it must be smaller that the value for no-
513           check-high.  When running in no-CHECK mode, as described above, if
514           the percentage of articles the remote server accepts drops below
515           this number, then the no-CHECK optimization is turned off until the
516           percentage gets above the no-check-high value again.  If there is
517           small difference between this and the no-check-high value (less
518           than about 5.0), then innfeed may frequently go in and out of no-
519           CHECK mode.  If the difference is too big, then it will make it
520           harder to get out of no-CHECK mode when necessary (wasting
521           bandwidth).  Keeping this to between 5.0 and 10.0 less than no-
522           check-high usually works pretty well.  The default value is 90.0.
523
524       no-check-filter
525           This is a floating-point value representing the time constant, in
526           articles, over which the CHECK/no-CHECK calculations are done.  The
527           default value is 50.0, which will implement an Infinite Impulse
528           Response (IIR) filter of time constant 50.  This roughly equates to
529           making a decision about the mode over the previous 50 articles.  A
530           higher number will result in a slower response to changing
531           percentages of articles accepted; a lower number will result in a
532           faster response.
533
534       port-number
535           This key requires a positive integer value.  It defines the TCP/IP
536           port number to use when connecting to the remote.  Usually, port
537           number 119 is used, which is the default value.
538
539       force-ipv4
540           This key requires a boolean value.  By default, it is set to false.
541           Setting it to true is the same as setting bindaddress6 to "none"
542           and removing bindaddress from "none" if it was set.
543
544       drop-deferred
545           This key requires a boolean value.  By default, it is set to false.
546           When set to true, and a peer replies with code 431 or 436 (try
547           again later), innfeed just drops the article and does not try to
548           re-send it.  This is useful for some peers that keep on deferring
549           articles for a long time to prevent innfeed from trying to offer
550           the same article over and over again.
551
552       min-queue-connection
553           This key requires a boolean value.  By default, it is set to false.
554           When set to true, innfeed will attempt to use a connection with the
555           least queue size (or the first empty connection).  If this key is
556           set to true, it is recommended that dynamic-method be set to 0.
557           This allows for article propagation with the least delay.
558
559       no-backlog
560           This key requires a boolean value.  It specifies whether spooling
561           should be enabled (false, the default) or disabled (true).  Note
562           that when no-backlog is set, articles reported as spooled are
563           actually silently discarded.
564
565       backlog-limit
566           This key requires a non-negative integer value.  If the number is 0
567           (the default), then backlog files are allowed to grow without bound
568           when the peer is unable to keep up with the article flow.  If this
569           number is greater than 0, then it specifies the size (in bytes) the
570           backlog file should get truncated to when the backlog file reaches
571           a certain limit.  The limit depends on whether backlog-factor or
572           backlog-limit-highwater is used.
573
574           This parameter also applies to the debug file when debug-shrinking
575           is set to true, and has the same effect on this file as the one has
576           on backlog files.
577
578       backlog-factor
579           This key requires a floating-point value, which must be larger than
580           1.0.  It is used in conjunction with the peer key backlog-limit.
581           If backlog-limit has a value greater than zero, then when the
582           backlog file gets larger than the value backlog-limit * backlog-
583           factor, then the backlog file will be truncated to the size
584           backlog-limit.
585
586           For example, if backlog-limit has a value of 1000000, and backlog-
587           factor has a value of 2.0, then when the backlog file gets to be
588           larger than 2000000 bytes in size, it will be truncated to 1000000
589           bytes.  The front portion of the file is removed, and the trimming
590           happens on line boundaries, so the final size may be a bit less
591           than this number.  If backlog-limit-highwater is defined too, then
592           backlog-factor takes precedence.  The default value of backlog-
593           factor is 1.1.
594
595           This parameter also applies to the debug file when debug-shrinking
596           is set to true, and has the same effect on this file as the one has
597           on backlog files.
598
599       backlog-limit-highwater
600           This key requires a positive integer value that must be larger than
601           the value for backlog-limit.  The default value is 0.
602
603           If the size of the backlog file gets larger than this value (in
604           bytes), then the backlog file will be shrunk down to the size of
605           backlog-limit.  If both backlog-factor and backlog-limit-highwater
606           are defined, then the value of backlog-factor is used.
607
608           This parameter also applies to the debug file when debug-shrinking
609           is set to true, and has the same effect on this file as the one has
610           on backlog files.
611
612       backlog-feed-first
613           This key requires a boolean value.  By default it is set to false.
614           When set to true, the backlog is fed before new files.  This is
615           intended to enforce in-order delivery, so setting this to true when
616           initial-connections or max-connections is more than 1 is
617           inconsistent.
618
619       bindaddress
620           This key requires a string value.  It specifies which outgoing IPv4
621           address innfeed should bind the local end of its connection to.  It
622           must be an IPv4 address in dotted-quad format (nnn.nnn.nnn.nnn),
623           "any", or "none".  If not set or set to "any", innfeed defaults to
624           letting the kernel choose this address.  If set to "none", innfeed
625           will not use IPv4 for outgoing connections to peers in this scope
626           (i.e. it forces IPv6).
627
628           If not set in innfeed.conf, innfeed defaults to the value of
629           sourceaddress from inn.conf (which by default is unset).
630
631       bindaddress6
632           This key requires a string value.  It behaves like bindaddress
633           except for outgoing IPv6 connections.  It must be in numeric IPv6
634           format (note that a value containing colons must be enclosed in
635           double quotes), "any", or "none".  If set to "none", innfeed will
636           not use IPv6 for outgoing connections to peers in this scope.
637
638           If not set in innfeed.conf, innfeed defaults to the value of
639           sourceaddress6 from inn.conf (which by default is unset).
640
641       username
642           This key requires a string value.  If the value is defined, then
643           innfeed tries to authenticate by AUTHINFO USER and this value used
644           for user name.  password must also be defined, if this key is
645           defined.
646
647       password
648           This key requires a string value.  The value is the password used
649           for AUTHINFO PASS.  username must also be defined, if this key is
650           defined.
651

PEER VALUES

653       As previously explained, the peer definitions can contain redefinitions
654       of any of the key:value pairs described in the section about global
655       peer defaults above.  There is one key:value pair that is specific to a
656       peer definition.
657
658       ip-name
659           This key requires a word value.  The word is either one of the
660           host's FQDNs, or the dotted-quad IP address of the peer for IPv4,
661           or the colon-separated IP address of the peer for IPv6.  If this
662           value is not specified, then the name of the peer in the enclosing
663           peer block is taken to also be its ip-name.
664

RELOADING

666       If innfeed gets a SIGHUP signal, then it will reread the configuration
667       file.  All values at global scope except for backlog-directory can be
668       changed (although note that bindaddress and bindaddress6 changes will
669       only affect new connections).
670
671       Any new peers are added and any missing peers have their connections
672       closed.
673
674       The log file is also reopened.
675

EXAMPLE

677       For a comprehensive example, see the sample innfeed.conf distributed
678       with INN and installed as a starting point.
679
680       Here are examples of how to format values:
681
682           eg-string:         "New\tconfig\tfile\n"
683           eg-long-string:    "A long string that goes
684                              over multiple lines.  The
685                              newline is kept in the
686                              string except when quoted
687                              with a backslash \
688                              as here."
689           eg-simple-string:  A-no-quote-string
690           eg-integer:        10
691           eg-boolean:        true
692           eg-char:           'a'
693           eg-ctrl-g:         '\007'
694

HISTORY

696       Written by James Brister <brister@vix.com> for InterNetNews.  Converted
697       to POD by Julien Elie.
698
699       Earlier versions of innfeed (up to 0.10.1) were shipped separately;
700       innfeed is now part of INN and shares the same version number.  Please
701       note that the innfeed.conf format has changed dramatically since
702       version 0.9.3.
703

SEE ALSO

705       inn.conf(5), innfeed(8), newsfeeds(5).
706
707
708
709INN 2.7.1                         2023-03-07                   INNFEED.CONF(5)
Impressum