1CONTROLCHAN(8)            InterNetNews Documentation            CONTROLCHAN(8)
2
3
4

NAME

6       controlchan - Channel-fed control message handler
7

SYNOPSIS

9       controlchan [-ch]
10

DESCRIPTION

12       controlchan removes the responsibility for handling control messages
13       (except cancels) from innd and instead processes them from a channel or
14       file feed.
15
16       The two Perl modules "Encode" and "MIME::Parser" are required by
17       controlchan.
18
19       To reduce load, controlchan keeps a copy of control.ctl and
20       control.ctl.local in memory and checks permissions (including any
21       required PGP headers) before any scripts are called.  These two
22       configuration files are automatically reloaded when controlchan notices
23       they have been modified.  Also, the default case of an unrecognized
24       control article is handled internally.  The "drop" case is handled with
25       far less fuss.
26
27       Normally, controlchan is invoked by innd as configured in newsfeeds.
28       An example entry is below.  Make sure that the newsgroup
29       "control.cancel" exists so that controlchan does not have to scan
30       through cancels, which it will not be processing anyway.
31
32           controlchan!\
33               :!*,control,control.*,!control.cancel\
34               :AC,Tc,Wnsm\
35               :<pathbin in inn.conf>/controlchan
36
37       controlchan can also be manually invoked with a mere path to a file
38       (containing a complete control article with its headers and its body)
39       or a token on its standard input:
40
41           echo '/path/to/a/control/article' | controlchan
42           echo '@0303465234000000000000235AE000000002@' | controlchan
43
44       Note that in the (very, very unlikely) event that you need to process
45       ihave/sendme control messages, be sure that logipaddr is set to false
46       in inn.conf, because in this case controlchan needs a site name, not an
47       IP address.
48
49       controlchan tries to report all log messages through syslog(3), unless
50       connected to an interactive terminal.  To enable syslog(3)'ing for
51       versions of Perl prior to 5.6.0, you will need to have run h2ph on your
52       system include files at some point (this is required to make
53       "Sys::Syslog" work).  If you have not done so, do this:
54
55           cd /usr/include
56           h2ph * sys/*
57
58       If you run FreeBSD, you will need to run the following in addition:
59
60           h2ph machine/*
61

OPTIONS

63       -c  By default, controlchan does not process articles whose Date: or
64           Injection-Date: header fields are too far in the past (more than
65           artcutoff days, as set in inn.conf) or one day in the future.  It
66           allows preventing a malicious replay of old control articles.
67
68           Using the -c flag disables this check on the cutoff date.
69
70       -h  Gives usage information.
71

HISTORY

73       Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.
74       Converted to POD by Julien Elie.
75

SEE ALSO

77       control.ctl(5), inn.conf(5).
78
79
80
81INN 2.6.5                         2022-01-23                    CONTROLCHAN(8)
Impressum