NEWS.DAILY(8)                                                    NEWS.DAILY(8)

       news.daily - do regular Usenet system administration

       news.daily [ keyword...  ]

       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, <USER specified with --with-news-mas-
       ter at configure>.  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) or expireindex(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 or
              expireindex.  The names of articles to be removed are written to
              a  temporary  file, and then renamed after expiration by calling
              expirerm(8).  If  the  ``delayrm''  keyword  is  specified,  the
              ``expireover'' keyword is specified implicitly.

              Specify the file to use as the expire.ctl(5) file for expire.

              By  default,  expire builds the new history(5) file and database
              in the same directory as the current files.  Using this  keyword
              specifies  a  different local to build the new files (by passing
              the ``-d'' flag to expire), which will  then  be  moved  to  the
              right location when finished.

       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 news.daily expects to be run only once a day, and  it
              does  various  things  (like rotating logs) that normally should
              only be done on daily basis. Use this keyword  any  extra  times
              news.daily  is  run in the day and the normal logfile processing
              (and rotation) will not be done.

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

              Expire    normally    appends   information   to   <pathlog   in
              inn.conf>/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'' keyword 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 keyword has no effect if the ``nologs''  keyword  is  used.
              The  ``norotate''  keyword  is  passed  on  to scanlogs if it is

              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 or indices.  If you have turned on the stor-
              age manager with the 'storageapi'  in  inn.conf(5),  expireindex
              program  is  called  instead.   If  storageapi  turned on and no
              overview data is created,  the  ``expireover''  keyword  is  not
              needed.   This  is  the  case  that  the  server  runs  only for
              feeder(no reader).

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

              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.

              If the ``lowmark'' keyword is used, ctlinnd(8) lowmark  is  used
              for renumbering active(5).  Normal ctlinnd(8) renumber operation
              will take long time.  With ``lowmark'' keyword  this  will  take
              less  time.   If the ``lowmark'' keyword is used, ``norenumber''
              keyword is not needed, since news.daily specifies it implicitly.

       News.daily   and   this   manual  page  written  by  Landon  Curt  Noll
       <> and Rich $alz <>.  This is revision, dated 1999/06/12.

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


Man(1) output converted with man2html
list of all man pages