controlchan man page on Mageia

Man page or keyword search:  
man Server   17783 pages
apropos Keyword Search (all sections)
Output format
Mageia logo
[printable version]

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
       (except cancels) from innd and instead processes them from a channel or
       file feed.

       The two Perl modules "Encode" and "MIME::Parser" are required by
       controlchan.

       To reduce load, controlchan keeps a copy of control.ctl and
       control.ctl.local in memory and checks permissions (including any
       required PGP headers) before any scripts are called.  These two
       configuration files are automatically 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" exists 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
       (containing a complete control article with its headers and its body)
       or a token 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 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/*

OPTIONS
       -c  By default, controlchan does not process articles whose Date: or
	   Injection-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 to prevent 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.

       $Id: controlchan.pod 9241 2011-07-12 09:57:44Z iulius $

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

INN 2.5.3			  2011-07-17			CONTROLCHAN(8)
[top]

List of man pages available for Mageia

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net