Provided by: inn2_2.5.2+20110413-1_i386 bug

NAME

       controlchan - channel-fed control message handler

SYNOPSIS

       controlchan

DESCRIPTION

       Controlchan  removes  the  responsibility for handling control messages
       (except cancels) from innd(8) and instead processes them from a channel
       or  file feed.  To reduce load, controlchan keeps a copy of control.ctl
       in memory and checks permissions (including any required  PGP  headers)
       before  any  scripts  are  called.  Also, the default (``bad message'')
       case is handled internally.  The ``drop'' case is handled with far less
       fuss.

       Normally, controlchan is invoked by innd(8) as configured in newsfeeds.
       An example entry is below.  Make sure that you've created the newsgroup
       control.cancel  so  that  controlchan  doesn't  have  to  scan  through
       cancels, which it won't process anyway.

            controlchan!\
               :!*,control,control.*,!control.cancel\
               :AC,Tc,Wnsm\
               :<pathbin in inn.conf>/controlchan

       Note that in the (very, very unlikely) event that you need  to  process
       ihave/sendme  control  messages, be sure that logipaddr is set to false
       in inn.conf, because in this case controlchan needs a site name, not an
       IP address.

       Controlchan  tries to report all log messages through syslog(3), unless
       connected to an interactive  terminal.   To  enable  syslog(3)'ing  for
       versions  of Perl prior to 5.6.0, you will need to have run ``h2ph'' on
       your system include files at some  point  (this  is  required  to  make
       ``Sys::Syslog'' work).  If you have not done so, do this:

            cd /usr/include
            h2ph * sys/*

       If you run FreeBSD, you will need to run the following in addition:

            h2ph machine/*

HISTORY

       Written  by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.  This
       is revision 8180, dated 2008-11-21.

SEE ALSO

       control.ctl(5), inn.conf(5).

                                                                CONTROLCHAN(8)