overchan(8) [debian man page]

OVERCHAN(8)						      System Manager's Manual						       OVERCHAN(8)

NAME

       overchan - update the news overview database

SYNOPSIS

       overchan [ -D dir ] [ -c ] [ file...  ]

DESCRIPTION

       Overchan  reads	article  data  from files or standard input if none are specified.  (A single dash in the file list means to read standard
       input.)	It uses this information to update the news overview database.	Overchan is designed to be used by  InterNetNews  or  the  C  News
       ``mkov'' packages to update the database as the articles come in.  The database for each newsgroup is stored in a file named .overview in a
       newsgroup directory within the overview database tree.

       Overchan locks the database file (by locking an auxiliary file) before appending the new data.  To purge  data  after  articles	have  been
       expired, see expireover(8).

       By default, overchan processes its input as an INN overview stream written as a ``WO'' entry in the newsfeeds(5) file, for example:

	      overview:*:Tc,WO:/usr/lib/news/bin/overchan

       This  data  consists  of  a  line of text, separated into two parts by a tab.  The first part is a list of all relative pathnames where the
       article has been written, with a single space between entries.  The second part is the data to be written into the  overview  file,  except
       that  the  initial article number is omitted.  The data in the overview files should be expired by running expireover(8).  This is normally
       done by adding the ``expireover'' flag to the news.daily(8) invocation.

OPTIONS

       -c     To process the output of the mkov(8) program, use the ``-c'' flag.  This format is described in the ``nov'' distribution.

       -D     The ``-D'' flag can be used to specify where the databases are stored.  The default directory is /var/spool/news/over.view.

HISTORY

       Written by Rob Robertson <rob@violet.berkeley.edu> and Rich $alz <rsalz@uunet.uu.net>  for  InterNetNews.   This  is  revision  1.9,  dated
       1996/10/29.

SEE ALSO

       expireover(8), news.daily(8), newsfeeds(5), newsoverview(5), newsoverview(8).

																       OVERCHAN(8)

EXPIREOVER(8)						      System Manager's Manual						     EXPIREOVER(8)

NAME

       expireover - Expire entries from the news overview database

SYNOPSIS

       expireover [ -a ] [ -D overviewdir ] [ -f file ] [ -n ] [ -O overview.fmt ] [ -s ] [ -v ] [ -z ] [ file...  ]

DESCRIPTION

       Expireover  expires  entries  from  the	news  overview	database.   It	reads  a  list	of  pathnames  (relative  to  the spool directory,
       /var/spool/news), from the specified files or standard input if none are specified.  (A file name of ``-'' may be used to specify the stan-
       dard input.)  It then removes any mention of those articles from the appropriate overview database.

OPTIONS

       -z     If  the ``-z'' flag is used, then the input is assumed to be sorted such that all entries for a newsgroup appear together so that it
	      can be purged at once.  This flag can be useful when used with the sorted output of expire(8)'s ``-z'' flag.

       -s     If the ``-s'' flag is used, then expireover will read the spool directory for all groups mentioned in the active(5) file, and remove
	      the overview entries of any articles that do not appear in the directory.

       -f     To specify an alternate file, use the ``-f'' flag; a name of ``-'' is taken to mean the standard input.

       -a     The  ``-a''  flag  reads the spool directory and adds any missing overview entries.  It will create files if necessary.  This can be
	      used to initialize a database, or to sync up a overview database that may be lacking articles due to a crash.   Overchan	should	be
	      running, to ensure that any incoming articles get included.  Using this flag implies the ``-s'' flag; the ``-f'' flag may be used to
	      add only a subset of the newsgroups.

       -v     To see a list of the entries that would be added or deleted, use the ``-v'' flag.

       -n     To perform no real updates, use the ``-n'' flag.

       -D     The ``-D'' flag can be used to specify where the databases are stored.  The default directory is /var/spool/news/over.view.

       -O     The ``-O'' flag may be used to specify an alternate location for the overview.fmt(5) file; this is normally only useful  for  debug-
	      ging.

HISTORY

       Written	by  Rob  Robertson <rob@violet.berkeley.edu> and Rich $alz <rsalz@uunet.uu.net> (with help from Dave Lawrence <tale@uunet.uu.net>)
       for InterNetNews.  This is revision 1.8, dated 1996/10/29.

SEE ALSO

       expire(8), overview.fmt(5).

																     EXPIREOVER(8)