inn::config(3pm) [suse man page]

INN::Config(3pm)					    InterNetNews Documentation						  INN::Config(3pm)

NAME

       Config.pm - Export all the variables an INN Perl script might need

DESCRIPTION

       This Perl module sets up any and all the variables that an INN Perl script might need.  More particularly, it allows to use inn.conf
       variables:  they are all provided by innconfval, as well as the version of INN (in the variable $INN::Config::version).	Other useful
       variables are also provided (directories, files, programs, masks, parameters) and you should have a look at the source code of the module
       to see what you can use in your Perl scripts.

       You only have to declare the module at the beginning of them:

	   use lib '<pathnews>/lib/perl';
	   use INN::Config;

       Then, you can for instance use:

	   print $INN::Config::localmaxartsize;

       to print the value of localmaxartsize as it is set in inn.conf.

       You can also specify a version when you import the module.  If you write:

	   use INN::Config 2.5.0;

       only versions of INN superior to 2.5.0 will be able to run the Perl script.

       It is also possible to import the variables directly in your namespace if you specify what you want to import:

	   use INN::Config qw($localmaxartsize $pathbin);

       Note that a legacy innshellvars.pl is also provided in pathnews/lib for compatibility reasons with old Perl scripts not shipped with INN.
       It was used by versions of INN anterior to 2.5.0.  The corresponding scripts for Shell and Tcl are, however, still in use:  innshellvars
       and innshellvars.tcl.  They offer the same capabilities as this module.

HISTORY

       innshellvars.pl was written by James Brister <brister@vix.com> for InterNetNews in 1996.  It was converted to the INN::Config Perl module
       by Julien Elie in 2007.

       $Id: Config.pm.in 8357 2009-02-27 17:56:00Z iulius $

SEE ALSO

       inn.conf(5), innconfval(1), perl(1).

INN 2.5.2							    2009-05-21							  INN::Config(3pm)

RC.NEWS(8)						    InterNetNews Documentation							RC.NEWS(8)

NAME

       rc.news - Start or stop INN daemons

SYNOPSIS

       rc.news [start | stop]

DESCRIPTION

       rc.news can be used to start or stop innd and supporting programs.  It checks to make sure INN is not already running, handles cases of
       unclean shutdown, finishes up tasks which might have been interrupted by the preceding shutdown, e-mails certain boot-time warnings to
       newsmaster (as set in inn.conf), and is generally safer and easier than starting and stopping everything directly.  It needs to be run as
       the news user so that files in pathrun are created with the right ownership (though this is less important for "rc.news stop").

       Programs run and stopped by this script include:

       o   Always:  innd is started or stopped.

       o   If doinnwatch is true in inn.conf:  innwatch is started and stopped.

       o   If docnfsstat is true in inn.conf:  cnfsstat is started and stopped.

       o   If ovmethod is set to "ovdb" in inn.conf:  ovdb_init is run; ovdb_server and ovdb_monitor are stopped.

       o   If rc.news.local exists in pathbin:	rc.news.local is run with argument "start" or "stop" (to perform site-specific startup or shutdown
	   tasks).

OPTIONS

       "start"
	   If the first argument is "start", or no first argument is given, rc.news initiates INN startup.

       "stop"
	   If the first argument is "stop", rc.news initiates INN shutdown.  It is recommended to throttle the server first as described in
	   ctlinnd(8).

EXAMPLES

       To start INN and leave certain error messages going to the terminal:

	      su - news -c <pathbin in inn.conf>/rc.news

       To run INN at startup time from appropriate system boot scripts:

	      su - news -c <pathbin>/rc.news >/dev/console

       To stop INN (throttling first):

	      <pathbin>/ctlinnd throttle reason
	      su - news -c '<pathbin>/rc.news stop'

BUGS

       Running "rc.news start" as root is never the right thing to do, so we should at minimum check for this and error, or perhaps change
       effective user ID.

HISTORY

       // FIXME:  any attribution for rc.news itself?

       This manual page written by Jeffrey M. Vinocur <jeff@litech.org> for InterNetNews.

       $Id: rc.news.pod 9340 2011-08-16 13:50:19Z iulius $

SEE ALSO

       ctlinnd(8), cnfsstat(8), inn.conf(5), innwatch(8), ovdb(5).

INN 2.5.3							    2011-08-22								RC.NEWS(8)