Provided by: inn2_2.5.2+20110413-1build1_amd64 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)