news.daily man page on 4.4BSD

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


       news.daily - do regular Usenet system administration

       news.daily [ keyword...	]

       innwatch [ -t sleeptime ] [ -f controlfile ] [ -l logfile ]

       expirerm file

       inncheck	 [  -v	]  [  -pedantic	 ]  [ -perms [ -fix ] ] [ -noperms ] [
       file...	]

       News.daily performs a number of important Usenet	 administrative	 func‐
       tions.	This  includes	producing  a  status report, removing old news
       articles, processing log files, rotating the archived log files, renum‐
       bering  the  active  file,  removing  any old socket files found in the
       ``firewall'' directory, and collecting the output.  This program should
       be run under the news administrator's id, not as root.

       By default, news.daily performs all of its functions and mails the out‐
       put to the news administrator, usenet.  By specifying  ``keywords''  on
       the  command line, it is possible to modify the functions performed, as
       well as change the arguments given to expire(8) and expireover(8).

       News.daily should be run once a day, typically out of cron(8).  It  may
       be run more often, but such invocations should at least use the ``noro‐
       tate'' keyword to prevent  the  log  files  from	 being	processed  and
       rotated too fast.

       The shlock(1) program is used to prevent simultaneous executions.

       The following keywords may be used:

	      This  uses  the ``-z'' flag when invoking expire and expireover.
	      The names of articles to be removed are written to  a  temporary
	      file, and then removed after expiration by calling expirerm.

       nostat This  keyword  disables  the  status report generated by innstat
	      (see newslog(8)).	 Without this keyword, the  status  report  is
	      the  first  function  performed,	just  prior  to	 obtaining the
	      news.daily lock.

	      By default, expire is  invoked  to  remove  old  news  articles.
	      Using this keyword disables this function.

	      Expire	    normally	    appends	  information	    to
	      /var/spool/news/data/expire.log (see  newslog(5)).   Using  this
	      keyword  causes  the  expire  output  to	be  handled as part of
	      news.daily's output.  It has no effect if the ``noexpire''  key‐
	      word is used.

       flags='expire args'
	      By  default,  expire is invoked with the an argument of ``-v1''.
	      Using this keyword changes the arguments to those specified.  Be
	      careful  to  use	quotes if multiple arguments are needed.  This
	      keyword has no effect if the ``noexpire'' keyword is used.

       nologs After expiration, scanlogs(8) is	invoked	 to  process  the  log
	      files.   Using  this  keyword  disables all log processing func‐

	      By default, log processing includes rotating  and	 cleaning  out
	      log  files.  Using this keyword disables the rotating and clean‐
	      ing aspect of the	 log  processing:  the	logs  files  are  only
	      scanned  for information and no contents are altered.  This key‐
	      word has no effect if the ``nologs'' keyword is used.

	      This keyword disables the ctlinnd(8) renumber  operation.	  Nor‐
	      mally,  the low-water mark for all newsgroups (see active(5)) is

       norm   By default, any socket ctlinnd socket that has not been modified
	      for  two days will be removed.  Using this keyword disables this

       nomail News.daily normally sends a mail message containing the  results
	      to the administrator.  Using this keyword causes this message to
	      be sent to stdout and stderr instead.  Normally,	all  utilities
	      invoked  by  the	script have their stdout and stderr redirected
	      into a file.  If the file is empty, no message is sent.

	      The expireover program is called after expiration to  purge  the
	      overview databases.

       expireoverflags='expireover args'
	      If  the ``expireover'' keyword is used, this keyword may be used
	      to specify the  flags  to	 be  passed  to	 expireover.   If  the
	      ``delayrm''  keyword  is	used, then the default value is ``-z''
	      and the list of deleted files; otherwise, the default  value  is

	      The  program specified by the given path is executed just before
	      any expiration is done.  A typical use is to specify  an	alter‐
	      nate  expiration program and use the ``noexpire'' keyword.  Mul‐
	      tiple programs may be specified; they will be invoked in order.

       The ``norotate'' keyword is passed on to scanlogs  if  it  is  invoked.
       Expirerm	 is a script that removes a list of files.  The specified file
       lists the files.	 It is sorted, and then fed into a pipeline  responsi‐
       ble for doing the removal, normally fastrm(8).  If there seemed to be a
       problem removing the files, then mail is sent to the  news  administra‐
       tor.    If   there   were   no	problems,  then	 file  is  renamed  to
       /var/spool/news/data/expire.list where it is kept  (for	safety)	 until
       the next day's expiration.

       Innwatch is a script that can be started at news boot time.  It period‐
       ically — every sleeptime seconds — examines the load average,  and  the
       number  of  free blocks and inodes on the spool partition, as described
       by its controlfile, innwatch.ctl(5).  If the load gets too high, or the
       disk  gets  too	full,  it  throttles  the  server.  When the condition
       restores, it unblocks the server.  In addition, on  each	 pass  through
       the loop it will check the specified logfile to see if it has been mod‐
       ified, and send mail to the news administrator if so.  It is usually  a
       good idea to set this to the syslog(3) file that receives critical news
       messages.  Upon receipt of an interrupt signal,	innwatch  will	report
       its status in the file /var/spool/news/data/innwatch.status.

       Inncheck	 is  a perl(1) script that verifies the syntax and permissions
       of all InterNetNews configuration files.	 If no files are specified, it
       checks  all  files.   A filename may be followed by an equal sign and a
       path to indicate the pathname  to  use  for  the	 file.	 For  example,
       ``newsfeeds=/tmp/nf'' will check the syntax of a new newsfeeds(5) with‐
       out requiring it to be installed.  If  the  ``-v''  flag	 is  used,  it
       prints status information as it checks each file.  If the ``-pedantic''
       flag is used, it checks the files for omissions which are not  strictly
       errors, but which might indicate a configuration error.

       If  any	file  is  specified,  only  the permissions on those files are
       checked.	 The ``-noperms'' flag	will  suppress	this  check.   If  the
       ``-perms''  flag	 is used the script verifies the ownership and permis‐
       sions of all files.  The ``-fix'' flag can also be  used	 so  that  the
       output can be executed as a shell script.

       News.daily   and	  this	 manual	 page  written	by  Landon  Curt  Noll
       <> and Rich $alz <>.  Inncheck written
       by  Brendan  Kehoe <> and Rich.  Innwatch written
       by Mike Cooper  <>  and  <>.   This  is
       revision 1.6, dated 1993/03/18.

       active(5),  ctlinnd(8),	expire(8),  fastrm(8), newslog(5), newslog(8),
       innwatch.ctl(5), shlock(1).


List of man pages available for 4.4BSD

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]
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