FreeBSD Manual Pages
CONTROLCHAN(8) InterNetNews Documentation CONTROLCHAN(8) NAME controlchan - Channel-fed control message handler SYNOPSIS controlchan [-ch] DESCRIPTION controlchan removes the responsibility for handling control messages (ex- cept cancels) from innd and instead processes them from a channel or file feed. The two Perl modules "Encode" and "MIME::Parser" are required by con- trolchan. To reduce load, controlchan keeps a copy of control.ctl and control.ctl.lo- cal in memory and checks permissions (including any required PGP headers) before any scripts are called. These two configuration files are automati- cally reloaded when controlchan notices they have been modified. Also, the default case of an unrecognized control article is handled internally. The "drop" case is handled with far less fuss. Normally, controlchan is invoked by innd as configured in newsfeeds. An example entry is below. Make sure that the newsgroup "control.cancel" ex- ists so that controlchan does not have to scan through cancels, which it will not be processing anyway. controlchan!\ :!*,control,control.*,!control.cancel\ :AC,Tc,Wnsm\ :<pathbin in inn.conf>/controlchan controlchan can also be manually invoked with a mere path to a file (con- taining a complete control article with its headers and its body) or a to- ken on its standard input: echo '/path/to/a/control/article' | controlchan echo '@0303465234000000000000235AE000000002@' | 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 ad- dress. controlchan tries to report all log messages through syslog(3), unless con- nected to an interactive terminal. OPTIONS -c By default, controlchan does not process articles whose Date or Injec- tion-Date header fields are too far in the past (more than artcutoff days, as set in inn.conf) or one day in the future. It allows prevent- ing a malicious replay of old control articles. Using the -c flag disables this check on the cutoff date. -h Gives usage information. HISTORY Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews. Converted to POD by Julien Elie. SEE ALSO control.ctl(5), inn.conf(5). INN 2.8.0 2024-09-08 CONTROLCHAN(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | HISTORY | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=controlchan&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>