overchan(8) [suse man page]

OVERCHAN(8)						    InterNetNews Documentation						       OVERCHAN(8)

NAME

       overchan - Batch update the INN overview database

SYNOPSIS

       overchan [file ...]

DESCRIPTION

       overchan reads overview data from the specified files or from standard input if no files are specified, and writes that data into the INN
       overview database.  (The file "-" means to read data from standard input as well.)

       Normally, overview data is stored by innd for articles as they're accepted.  For performance, however, it's sometimes useful to have
       overview data written by a separate process.  To do this, set useoverchan to true in inn.conf to tell innd to not write overview data
       directly and then add an overchan channel in newsfeeds:

	   overview!:*:Tc,WnteO:<pathbin>/overchan

       where <pathbin> is pathbin in inn.conf.	Additionally, overchan can be used to bulk-load overview data from appropriately formatted batch
       files (such as overflow files from an overchan channel).

       Each line of input should have the following format:

	   <token> <arrived> <expires> <data>

       where <token> is the storage API token of the article in textual form (surrounded by "@" characters), <arrived> is the arrival timestamp of
       the article in seconds since epoch, <expires> is the expiration time of the article in seconds since epoch or 0 if there is none, and
       <data> is the tab-separated overview data.  Each of these fields must be separated by a single space.

HISTORY

       Written by Rob Robertson <rob@violet.berkeley.edu> and Rich $alz <rsalz@uunet.uu.net> for InterNetNews.	Man page rewritten in POD by Russ
       Allbery <rra@stanford.edu>.

       $Id: overchan.pod 7851 2008-05-26 19:33:08Z iulius $

SEE ALSO

       inn.conf(5), innd(8), newsfeeds(5)

INN 2.5.2							    2009-05-21							       OVERCHAN(8)

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)