1INNFEED.CONF(5) InterNetNews Documentation INNFEED.CONF(5)
2
3
4
6 innfeed.conf - Configuration file for innfeed
7
9 The innfeed.conf file configures to which remote peers innfeed sends
10 NNTP feeds.
11
12 A common entry to parameter "news.server.com" as an outgoing feed is:
13
14 peer news.server.com {
15 ip-name: "news.server.com"
16 }
17
18 If standard NNTP port 119 is not used, you may specify an alternate
19 port as follows:
20
21 peer news.server.com {
22 ip-name: "news.server.com"
23 port-number: 433
24 }
25
26 After any changes, run "inncheck" to perform basic syntax checks, and
27 reload this configuration file with the following command which makes
28 innd respawn a new instance of innfeed (assuming "innfeed!" is the name
29 of the corresponding channel feed in newsfeeds):
30
31 ctlinnd flush innfeed!
32
34 The configuration file innfeed.conf in pathetc is used to control the
35 innfeed(8) program. It is a fairly free-format file that consists of
36 three types of entries: key:value, peer and group. Comments are from
37 the hash character "#" to the end of the line.
38
39 key:value entries are a keyword and a value separated by a colon (which
40 can itself be surrounded by whitespace). For example:
41
42 max-connections: 10
43
44 A legal key starts with a letter and contains only letters, digits, and
45 the "_" and "-" characters. There are 5 different types of values:
46 integers, floating-point numbers, characters, booleans, and strings.
47
48 Integer and floating-point numbers are as to be expected, except that
49 exponents in floating-point numbers are not supported. A boolean value
50 is either "true" or "false" (case is not significant). A character
51 value is a single-quoted character as defined by the C-language. A
52 string value is any other sequence of characters. If the string needs
53 to contain whitespace, then it must be quoted with double quotes, and
54 uses the same format for embedding non-printing characters as normal
55 C-language string.
56
57 Peer entries look like:
58
59 peer <name> {
60 # body ...
61 }
62
63 The word "peer" is required. The <name> is the same as the site name
64 in INN's newsfeeds configuration file. The body of a peer entry
65 contains some number (possibly zero) of key:value entries.
66
67 Group entries look like:
68
69 group <name> {
70 # body ...
71 }
72
73 The word "group" is required. The <name> is any string valid as a key.
74 The body of a group entry contains any number of the three types of
75 entries. So key:value pairs can be defined inside a group, and peers
76 can be nested inside a group, and other groups can be nested inside a
77 group.
78
79 key:value entries that are defined outside of all peer and group
80 entries are said to be at "global scope". There are global key:value
81 entries that apply to the process as a whole (for example the location
82 of the backlog file directory), and there are global key:value entries
83 that act as defaults for peers. When innfeed looks for a specific
84 value in a peer entry (for example, the maximum number of connections
85 to set up), if the value is not defined in the peer entry, then the
86 enclosing groups are examined for the entry (starting at the closest
87 enclosing group). If there are no enclosing groups, or the enclosing
88 groups do not define the key:value, then the value at global scope is
89 used.
90
91 A small example could be:
92
93 # Global value applied to all peers that have
94 # no value of their own.
95 max-connections: 5
96
97 # A peer definition. "uunet" is the name used by innd
98 # in the newsfeeds configuration file.
99 peer uunet {
100 ip-name: usenet1.uu.net
101 }
102
103 peer vixie {
104 ip-name: gw.home.vix.com
105 max-connections: 10 # Override global value.
106 }
107
108 # A group of two peers which can handle more connections
109 # than normal.
110 group fast-sites {
111 max-connections: 15
112
113 # Another peer. The "max-connections" value from the
114 # "fast-sites" group scope is used. The "ip-name" value
115 # defaults to the peer's name.
116 peer data.ramona.vix.com {
117 }
118
119 peer bb.home.vix.com {
120 max-connections: 20 # He can really cook.
121 }
122 }
123
124 Given the above configuration file, the defined peers would have the
125 following values for the max-connections key:
126
127 uunet 5
128 vixie 10
129 data.ramona.vix.com 15
130 bb.home.vix.com 20
131
132 innfeed ignores key:value pairs it is not interested in. Some
133 configuration file values can be set via a command-line option, in
134 which case that setting overrides the settings in the file.
135
136 Configuration files can be included in other configuration files via
137 the syntax:
138
139 $INCLUDE filename
140
141 There is a maximum nesting depth of 10.
142
143 For a fuller example configuration file, see the supplied innfeed.conf.
144
146 The following listing show all the keys that apply to the process as
147 whole. These are not required (compiled-in defaults are used where
148 needed).
149
150 news-spool
151 This key requires a pathname value and defaults to patharticles in
152 inn.conf. It specifies where the top of the article spool is.
153 This corresponds to the -a command-line option.
154
155 input-file
156 This key requires a pathname value. It specifies the pathname
157 (relative to the backlog-directory value) that should be read in
158 funnel-file mode. This corresponds to giving a filename as an
159 argument on the command-line (i.e. its presence also implies that
160 funnel-file mode should be used).
161
162 The default is unset; innfeed then runs in channel or batch mode.
163
164 pid-file
165 This key requires a pathname value and defaults to innfeed.pid. It
166 specifies the pathname (relative to pathrun in inn.conf) where the
167 pid of the innfeed process should be stored. This corresponds to
168 the -p command-line option.
169
170 debug-level
171 This key defines the debug level for the process. Default is 0. A
172 non-zero number generates a lot of messages to stderr, or to the
173 config-defined log-file. This corresponds to the -d command-line
174 option.
175
176 If a file named innfeed.debug exists in the pathlog directory (as
177 set in inn.conf), then debug-level is automatically set to 1. This
178 is a cheap way of avoiding continual reloading of the newsfeeds
179 file when debugging. Note that debug messages still go to log-
180 file.
181
182 debug-shrinking
183 This key requires a boolean value and defaults to false (the debug
184 file is allowed to grow without bound). If set to true, this file
185 is truncated when its size reaches a certain limit. See backlog-
186 limit for more details.
187
188 initial-sleep
189 This key requires a positive integer. The default value is 2. It
190 defines the number of seconds to wait when innfeed (or a fork)
191 starts, before beginning to open connections to remote hosts.
192
193 fast-exit
194 This key requires a boolean value and defaults to false. If set to
195 true, when innfeed receives a SIGTERM or SIGQUIT signal, it will
196 close its listeners as soon as it can, even if it means dropping
197 articles.
198
199 use-mmap
200 This key requires a boolean value and defaults to true. When
201 innfeed is given file names to send (a fairly rare use case)
202 instead of storage API tokens, it specifies whether mmaping should
203 be used if innfeed has been built with mmap(2) support. If article
204 data on disk is not in NNTP-ready format (CR/LF at the end of each
205 line), then after mmaping, the article is read into memory and
206 fixed up, so mmaping has no positive effect (and possibly some
207 negative effect depending on your system), and so in such a case
208 this value should be "false", which corresponds to the -M command-
209 line option.
210
211 log-file
212 This key requires a pathname value and defaults to innfeed.log. It
213 specifies where any logging messages that could not be sent via
214 syslog(3) should go (such as those generated when a positive value
215 for debug-value is used). This corresponds to the -l command-line
216 option.
217
218 This pathname is relative to pathlog in inn.conf.
219
220 log-time-format
221 This key requires a format string suitable for strftime(3). It is
222 used for messages sent via syslog(3) and to the status-file.
223 Default value is "%a %b %d %H:%M:%S %Y".
224
225 backlog-directory
226 This key requires a pathname value and defaults to innfeed. It
227 specifies where the current innfeed process should store backlog
228 files. This corresponds to the -b command-line option.
229
230 This pathname is relative to pathspool in inn.conf.
231
232 backlog-highwater
233 This key requires a positive integer value and defaults to 5. It
234 specifies how many articles should be kept on the backlog file
235 queue before starting to write new entries to disk.
236
237 backlog-ckpt-period
238 This key requires a positive integer value and defaults to 30. It
239 specifies how many seconds elapse between checkpoints of the input
240 backlog file. Too small a number will mean frequent disk accesses;
241 too large a number will mean after a crash, innfeed will re-offer
242 more already-processed articles than necessary.
243
244 backlog-newfile-period
245 This key requires a positive integer value and defaults to 600. It
246 specifies how many seconds elapse before each check for externally
247 generated backlog files that are to be picked up and processed.
248
249 backlog-rotate-period
250 This key requires a positive integer value and defaults to 60. It
251 specifies how many seconds elapse before innfeed checks for a
252 manually created backlog file and moves the output backlog file to
253 the input backlog file.
254
255 dns-retry
256 This key requires a positive integer value and defaults to 900. It
257 defines the number of seconds between attempts to re-lookup host
258 information that previously failed to be resolved.
259
260 dns-expire
261 This key requires a positive integer value and defaults to 86400.
262 It defines the number of seconds between refreshes of name to
263 address DNS translation. This is so long-running processes do not
264 get stuck with stale data, should peer IP addresses change.
265
266 gen-html
267 This key requires a boolean value and defaults to false. It
268 specifies whether the status-file should be HTML-ified.
269
270 status-file
271 This key requires a pathname value and defaults to innfeed.status.
272 An absolute pathname can be used. It specifies the pathname
273 (relative to pathhttp when gen-html is true; otherwise, pathlog as
274 set in inn.conf) where the periodic status of the innfeed process
275 should be stored. This corresponds to the -S command-line option.
276
277 connection-stats
278 This key requires a boolean value and defaults to false. If the
279 value is true, then whenever the transmission statistics for a peer
280 are logged, each active connection logs its own statistics. This
281 corresponds to the -z command-line option.
282
283 host-queue-highwater
284 This key requires a positive integer value and defaults to 10. It
285 defines how many articles will be held internally for a peer before
286 new arrivals cause article information to be spooled to the backlog
287 file.
288
289 stats-period
290 This key requires a positive integer value and defaults to 600. It
291 defines how many seconds innfeed waits between generating
292 statistics on transfer rates.
293
294 stats-reset
295 This key requires a positive integer value and defaults to 43200.
296 It defines how many seconds innfeed waits before resetting all
297 internal transfer counters back to zero (after logging one final
298 time). This is so a innfeed process running more than a day will
299 generate "final" stats that will be picked up by logfile processing
300 scripts.
301
302 initial-reconnect-time
303 This key requires a positive integer value and defaults to 30. It
304 defines how many seconds to first wait before retrying to reconnect
305 after a connection failure. If the next attempt fails too, then
306 the reconnect time is approximately doubled until the connection
307 succeeds, or max-reconnect-time is reached.
308
309 max-reconnect-time
310 This key requires an integer value and defaults to 3600. It
311 defines the maximum number of seconds to wait between attempt to
312 reconnect to a peer. The initial value for reconnection attempts
313 is defined by initial-reconnect-time, and it is doubled after each
314 failure, up to this value.
315
316 stdio-fdmax
317 This key requires a non-negative integer value and defaults to 0.
318 If the value is greater than zero, then whenever a network socket
319 file descriptor is created and it has a value less than this, the
320 file descriptor will be dup'ed to bring the value up greater than
321 this. This is to leave lower numbered file descriptors free for
322 stdio. Certain systems, Sun's in particular, require this. SunOS
323 4.1.x usually requires a value of 128 and Solaris requires a value
324 of 256. The default if this is not specified, is 0.
325
326 Special keys for imapfeed
327 The following keys are used with imapfeed to authenticate to a remote
328 host. Several parameters may be included at global scope:
329
330 deliver-authname
331 The authname is who you want to authenticate as.
332
333 deliver-password
334 This is the appropriate password for authname.
335
336 deliver-username
337 The username is who you want to "act" as, that is, who is actually
338 going to be using the server.
339
340 deliver-realm
341 In this case, the "realm" is the realm in which the specified
342 authname is valid. Currently this is only needed by the DIGEST-MD5
343 SASL mechanism.
344
345 deliver-rcpt-to
346 A printf(3)-style format string for creating the envelope recipient
347 address. The pattern MUST include a single string specifier which
348 will be replaced with the newgroup (e.g. "bb+%s"). The default is
349 "+%s".
350
351 deliver-to-header
352 An optional printf(3)-style format string for creating a To: header
353 field to be prepended to the article. The pattern MUST include a
354 single string specifier which will be replaced with the newgroup
355 (e.g. "post+%s@domain"). If not specified, the To: header field
356 will not be prepended.
357
359 All the key:value pairs mentioned in this section can be specified at
360 global scope. They may also be specified inside a group or peer
361 definition. Note that when peers are added dynamically (i.e. when
362 innfeed receives an article for an unspecified peer), it will add the
363 peer site using the parameters specified at global scope.
364
365 Required keys
366 No keys are currently required. They all have a default value, if not
367 present in the configuration file.
368
369 Optional keys
370 The following keys are optional:
371
372 article-timeout
373 This key requires a non-negative integer value. The default value
374 is 600. If no articles need to be sent to the peer for this many
375 seconds, then the peer is considered idle and all its active
376 connections are torn down.
377
378 response-timeout
379 This key requires a non-negative integer value. The default value
380 is 300. It defines the maximum amount of time to wait for a
381 response from the peer after issuing a command.
382
383 initial-connections
384 This key requires a non-negative integer value. The default value
385 is 1. It defines the number of connections to be opened
386 immediately when setting up a peer binding. A value of 0 means no
387 connections will be created until an article needs to be sent.
388
389 max-connections
390 This key requires a positive integer value. The default value is 2
391 but may be increased if needed or for large feeds. It defines the
392 maximum number of connections to run in parallel to the peer. A
393 value of 0 specifies an unlimited number of maximum connections.
394 In general, use of an unlimited number of maximum connections is
395 not recommended. Do not ever set max-connections to zero with
396 dynamic-method 0 set, as this will saturate peer hosts with
397 connections.
398
399 close-period
400 This key requires a positive integer value and defaults to 86400.
401 It is the maximum number of seconds a connection should be kept
402 open. Some NNTP servers do not deal well with connections being
403 held open for long periods.
404
405 dynamic-method
406 This key requires an integer value between 0 and 3. The default
407 value is 3. It controls how connections are opened, up to the
408 maximum specified by max-connections. In general (and
409 specifically, with dynamic-method 0), a new connection is opened
410 when the current number of connections is below max-connections,
411 and an article is to be sent while no current connections are idle.
412 Without further restraint (i.e. using dynamic-method 0), in
413 practice this means that max-connections connections are
414 established while articles are being sent. Use of other dynamic-
415 method settings imposes a further limit on the amount of
416 connections opened below that specified by max-connections. This
417 limit is calculated in different ways, depending of the value of
418 dynamic-method.
419
420 Users should note that adding additional connections is not always
421 productive -- just because opening twice as many connections
422 results in a small percentage increase of articles accepted by the
423 remote peer, this may be at considerable resource cost both locally
424 and at the remote site, whereas the remote site might well have
425 received the extra articles sent from another peer a fraction of a
426 second later. Opening large numbers of connections is considered
427 antisocial.
428
429 The meanings of the various settings are:
430
431 0 (no method)
432 Increase of connections up to max-connections is unrestrained.
433
434 1 (maximize articles per second)
435 Connections are increased (up to max-connections) and decreased
436 so as to maximize the number of articles per second sent, while
437 using the fewest connections to do this.
438
439 2 (set target queue length)
440 Connections are increased (up to max-connections) and decreased
441 so as to keep the queue of articles to be sent within the bounds
442 set by dynamic-backlog-low and dynamic-backlog-high, while using
443 the minimum resources possible. As the queue will tend to fill
444 if the site is not keeping up, this method ensures that the
445 maximum number of articles are offered to the peer while using
446 the minimum number of connections to achieve this.
447
448 3 (combination)
449 This method uses a combination of methods 1 and 2 above. For
450 sites accepting a large percentage of articles, method 2 will be
451 used to ensure these sites are offered as complete a feed as
452 possible. For sites accepting a small percentage of articles,
453 method 1 is used, to minimize remote resource usage. For
454 intermediate sites, an appropriate combination is used.
455
456 dynamic-backlog-low
457 This key requires a floating-point value between 0 and 100. It
458 represents (as a percentage) the low water mark for the host queue.
459 If the host queue falls below this level while using dynamic-method
460 2 or 3, and if 2 or more connections are open, innfeed will attempt
461 to drop connections to the host. An Infinite Impulse Response
462 (IIR) filter is applied to the value to prevent connection flap
463 (see dynamic-filter). The default value is 20.0. This value must
464 be smaller than dynamic-backlog-high.
465
466 dynamic-backlog-high
467 This key requires a floating-point value between 0 and 100. It
468 represents (as a percentage) the high water mark for the host
469 queue. If the host queue rises above this level while using
470 dynamic-method 2 or 3, and if less than max-connections are open to
471 the host, innfeed will attempt to open further connections to the
472 host. An Infinite Impulse Response (IIR) filter is applied to the
473 value to prevent connection flap (see dynamic-filter). The default
474 value is 50.0. This value must be larger than dynamic-backlog-low.
475
476 dynamic-backlog-filter
477 This key requires a floating-point value between 0 and 1. It
478 represents the filter coefficient used by the Infinite Impulse
479 Response (IIR) filter used to implement dynamic-method 2 and 3.
480 The default value of this filter is 0.7, giving a time constant of
481 1/(1-0.7) articles. Higher values will result in slower response
482 to queue fullness changes; lower values in faster response.
483
484 max-queue-size
485 This key requires a positive integer value. The default value is
486 20. It defines the maximum number of articles to process at one
487 time when using streaming to transmit to a peer. Larger numbers
488 mean more memory consumed as articles usually get pulled into
489 memory (see the description of use-mmap).
490
491 streaming
492 This key requires a boolean value. Its default value is true. It
493 defines whether streaming commands are used to transmit articles to
494 the peers.
495
496 no-check-high
497 This key requires a floating-point number which must be in the
498 range [0.0, 100.0]. When running transmitting with the streaming
499 commands, innfeed attempts an optimization called "no-CHECK mode".
500 This involves not asking the peer if it wants the article, but just
501 sending it. This optimization occurs when the percentage of the
502 articles the peer has accepted gets larger than this number. If
503 this value is set to 100.0, then this effectively turns off no-
504 CHECK mode, as the percentage can never get above 100.0. If this
505 value is too small, then the number of articles the peer rejects
506 will get bigger (and your bandwidth will be wasted). The default
507 value of 95.0 usually works pretty well.
508
509 no-check-low
510 This key requires a floating-point number which must be in the
511 range [0.0, 100.0], and it must be smaller that the value for no-
512 check-high. When running in no-CHECK mode, as described above, if
513 the percentage of articles the remote server accepts drops below
514 this number, then the no-CHECK optimization is turned off until the
515 percentage gets above the no-check-high value again. If there is
516 small difference between this and the no-check-high value (less
517 than about 5.0), then innfeed may frequently go in and out of no-
518 CHECK mode. If the difference is too big, then it will make it
519 harder to get out of no-CHECK mode when necessary (wasting
520 bandwidth). Keeping this to between 5.0 and 10.0 less than no-
521 check-high usually works pretty well. The default value is 90.0.
522
523 no-check-filter
524 This is a floating-point value representing the time constant, in
525 articles, over which the CHECK/no-CHECK calculations are done. The
526 default value is 50.0, which will implement an Infinite Impulse
527 Response (IIR) filter of time constant 50. This roughly equates to
528 making a decision about the mode over the previous 50 articles. A
529 higher number will result in a slower response to changing
530 percentages of articles accepted; a lower number will result in a
531 faster response.
532
533 port-number
534 This key requires a positive integer value. It defines the TCP/IP
535 port number to use when connecting to the remote. Usually, port
536 number 119 is used, which is the default value.
537
538 force-ipv4
539 This key requires a boolean value. By default, it is set to false.
540 Setting it to true is the same as setting bindaddress6 to "none"
541 and removing bindaddress from "none" if it was set.
542
543 drop-deferred
544 This key requires a boolean value. By default, it is set to false.
545 When set to true, and a peer replies with code 431 or 436 (try
546 again later), innfeed just drops the article and does not try to
547 re-send it. This is useful for some peers that keep on deferring
548 articles for a long time to prevent innfeed from trying to offer
549 the same article over and over again.
550
551 min-queue-connection
552 This key requires a boolean value. By default, it is set to false.
553 When set to true, innfeed will attempt to use a connection with the
554 least queue size (or the first empty connection). If this key is
555 set to true, it is recommended that dynamic-method be set to 0.
556 This allows for article propagation with the least delay.
557
558 no-backlog
559 This key requires a boolean value. It specifies whether spooling
560 should be enabled (false, the default) or disabled (true). Note
561 that when no-backlog is set, articles reported as spooled are
562 actually silently discarded.
563
564 backlog-limit
565 This key requires a non-negative integer value. If the number is 0
566 (the default), then backlog files are allowed to grow without bound
567 when the peer is unable to keep up with the article flow. If this
568 number is greater than 0, then it specifies the size (in bytes) the
569 backlog file should get truncated to when the backlog file reaches
570 a certain limit. The limit depends on whether backlog-factor or
571 backlog-limit-highwater is used.
572
573 This parameter also applies to the debug file when debug-shrinking
574 is set to true, and has the same effect on this file as the one has
575 on backlog files.
576
577 backlog-factor
578 This key requires a floating-point value, which must be larger than
579 1.0. It is used in conjunction with the peer key backlog-limit.
580 If backlog-limit has a value greater than zero, then when the
581 backlog file gets larger than the value backlog-limit * backlog-
582 factor, then the backlog file will be truncated to the size
583 backlog-limit.
584
585 For example, if backlog-limit has a value of 1000000, and backlog-
586 factor has a value of 2.0, then when the backlog file gets to be
587 larger than 2000000 bytes in size, it will be truncated to 1000000
588 bytes. The front portion of the file is removed, and the trimming
589 happens on line boundaries, so the final size may be a bit less
590 than this number. If backlog-limit-highwater is defined too, then
591 backlog-factor takes precedence. The default value of backlog-
592 factor is 1.1.
593
594 This parameter also applies to the debug file when debug-shrinking
595 is set to true, and has the same effect on this file as the one has
596 on backlog files.
597
598 backlog-limit-highwater
599 This key requires a positive integer value that must be larger than
600 the value for backlog-limit. The default value is 0.
601
602 If the size of the backlog file gets larger than this value (in
603 bytes), then the backlog file will be shrunk down to the size of
604 backlog-limit. If both backlog-factor and backlog-limit-highwater
605 are defined, then the value of backlog-factor is used.
606
607 This parameter also applies to the debug file when debug-shrinking
608 is set to true, and has the same effect on this file as the one has
609 on backlog files.
610
611 backlog-feed-first
612 This key requires a boolean value. By default it is set to false.
613 When set to true, the backlog is fed before new files. This is
614 intended to enforce in-order delivery, so setting this to true when
615 initial-connections or max-connections is more than 1 is
616 inconsistent.
617
618 bindaddress
619 This key requires a string value. It specifies which outgoing IPv4
620 address innfeed should bind the local end of its connection to. It
621 must be an IPv4 address in dotted-quad format (nnn.nnn.nnn.nnn),
622 "any", or "none". If not set or set to "any", innfeed defaults to
623 letting the kernel choose this address. If set to "none", innfeed
624 will not use IPv4 for outgoing connections to peers in this scope
625 (i.e. it forces IPv6).
626
627 If not set in innfeed.conf, innfeed defaults to the value of
628 sourceaddress from inn.conf (which by default is unset).
629
630 bindaddress6
631 This key requires a string value. It behaves like bindaddress
632 except for outgoing IPv6 connections. It must be in numeric IPv6
633 format (note that a value containing colons must be enclosed in
634 double quotes), "any", or "none". If set to "none", innfeed will
635 not use IPv6 for outgoing connections to peers in this scope.
636
637 If not set in innfeed.conf, innfeed defaults to the value of
638 sourceaddress6 from inn.conf (which by default is unset).
639
640 username
641 This key requires a string value. If the value is defined, then
642 innfeed tries to authenticate by AUTHINFO USER and this value used
643 for user name. password must also be defined, if this key is
644 defined.
645
646 password
647 This key requires a string value. The value is the password used
648 for AUTHINFO PASS. username must also be defined, if this key is
649 defined.
650
652 As previously explained, the peer definitions can contain redefinitions
653 of any of the key:value pairs described in the section about global
654 peer defaults above. There is one key:value pair that is specific to a
655 peer definition.
656
657 ip-name
658 This key requires a word value. The word is either one of the
659 host's FQDNs, or the dotted-quad IP address of the peer for IPv4,
660 or the colon-separated IP address of the peer for IPv6. If this
661 value is not specified, then the name of the peer in the enclosing
662 peer block is taken to also be its ip-name.
663
665 If innfeed gets a SIGHUP signal, then it will reread the configuration
666 file. All values at global scope except for backlog-directory can be
667 changed (although note that bindaddress and bindaddress6 changes will
668 only affect new connections).
669
670 Any new peers are added and any missing peers have their connections
671 closed.
672
673 The log file is also reopened.
674
676 For a comprehensive example, see the sample innfeed.conf distributed
677 with INN and installed as a starting point.
678
679 Here are examples of how to format values:
680
681 eg-string: "New\tconfig\tfile\n"
682 eg-long-string: "A long string that goes
683 over multiple lines. The
684 newline is kept in the
685 string except when quoted
686 with a backslash \
687 as here."
688 eg-simple-string: A-no-quote-string
689 eg-integer: 10
690 eg-boolean: true
691 eg-char: 'a'
692 eg-ctrl-g: '\007'
693
695 Written by James Brister <brister@vix.com> for InterNetNews. Converted
696 to POD by Julien Elie.
697
698 Earlier versions of innfeed (up to 0.10.1) were shipped separately;
699 innfeed is now part of INN and shares the same version number. Please
700 note that the innfeed.conf format has changed dramatically since
701 version 0.9.3.
702
704 inn.conf(5), innfeed(8), newsfeeds(5).
705
706
707
708INN 2.6.5 2022-02-18 INNFEED.CONF(5)