expireover man page on YellowDog

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

EXPIREOVER(8)		  InterNetNews Documentation		 EXPIREOVER(8)

NAME
       expireover - Expire entries from the news overview database

SYNOPSIS
       expireover [-ekNpqs] [-f file] [-w offset] [-z rmfile] [-Z lowmarkfile]

DESCRIPTION
       expireover expires old entries from the news overview database.	It
       reads in a list of newsgroups (by default from pathdb/active, but a
       different file can be specified with the -f option) and then removes
       from the overview database mentions of any articles that no longer
       exist in the news spool.

       If groupbaseexpiry in inn.conf is true, expireover also removes old
       articles from the news spool according to the expiration rules in
       expire.ctl.  Otherwise it only removes overview entries for articles
       that have already been removed by some other process, and -e, -k, -N,
       -p, -q, -w, and -z are all ignored.

       When groupbaseexpiry is set, the default behavior of expireover is to
       remove the article from the spool once it expires out of all of the
       newsgroups to which it was crossposted.	The article is, however,
       removed from the overview database of each newsgroup as soon as it
       expires out of that individual newsgroup.  The effect is that an arti‐
       cle crossposted to several groups will be removed from the overview
       database from each group one-by-one as its age passes the expiration
       threshold for that group as set in expire.ctl, and then when it expires
       out of the last newsgroup, it will be deleted from the news spool.

       Articles that are stored in self-expiring storage backends such as CNFS
       are normally treated differently and not expired until they expire out
       of the backend regardless of expire.ctl.	 See -N, however.

       By default, expireover purges all overview information for newsgroups
       that have been removed from the server; this behavior is suppressed if
       -f is given.

OPTIONS
       -e  Remove articles from the news spool and all overview databases as
	   soon as they expire out of any newsgroup to which they are posted,
	   rather than retain them until they expire out of all newsgroups.
	   -e and -k cannot be used at the same time.  This flag is ignored if
	   groupbaseexpiry is false.

       -f file
	   Use file as the newsgroup list instead of pathdb/active.  file can
	   be "-" to indicate standard input.  Using this flag suppresses the
	   normal purge of all overview information from newsgroups that have
	   been removed from the server.

       -k  Retain all overview information for an article, as well as the
	   article itself, until it expires out of all newsgroups to which it
	   was posted.	This can cause articles to stick around in a newsgroup
	   for longer than the expire.ctl rules indicate, when they're cross‐
	   posted.  -e and -k cannot be used at the same time.	This flag is
	   ignored if groupbaseexpiry is false.

       -N  Apply expire.ctl rules to expire articles even from storage methods
	   that have self-expire functionality.	 This may remove articles from
	   self-expiring storage methods before the articles "naturally"
	   expire.  This flag is ignored if groupbaseexpiry is false.

       -p  By default, expireover bases decisions on whether to remove an
	   article on the arrival time on the server.  This means that arti‐
	   cles may be kept a little longer than if the decision were based on
	   the article's posting date.	If this option is given, expiration
	   decisions are based on the article posting date instead.  This flag
	   is ignored if groupbaseexpiry is false.

       -q  expireover normally prints statistics at the end of the expiration
	   process.  -q suppresses this report.	 This flag is ignored if
	   groupbaseexpiry is false.

       -s  expireover normally only checks the existence of articles in the
	   news spool if querying the storage method for that article to see
	   if it still exists is considered "inexpensive."  To always check
	   the existence of all articles regardless of how resource-intensive
	   this may be, use the -s flag.  See storage.conf(5) for more infor‐
	   mation about this metric.

       -w offset
	   "Warps" time so that expireover thinks that it's running at some
	   time other than the current time.  This is occasionally useful to
	   force groups to be expired or not expired without changing
	   expire.ctl for the expire run.  offset should be a signed floating
	   point number specifying the number of days difference from the cur‐
	   rent time to use as "now."  This flag is ignored if groupbaseexpiry
	   is false.

       -z rmfile
	   Don't remove articles immediately but instead write the path to the
	   article or the token of the article to rmfile, which is suitable
	   input for fastrm(1).	 This can substantially speed up deletion of
	   expired articles for those storage methods where each article is a
	   single file (such as tradspool and timehash).  See the description
	   of delayrm in news.daily(8) for more details.  This flag is ignored
	   if groupbaseexpiry is false.

       -Z lowmarkfile
	   Write the lowest article numbers for each newsgroup as it's expired
	   to the specified file.  This file is then suitable for "ctlinnd
	   lowmark".  See ctlinnd(8) for more information.

EXAMPLES
       Normally expireover is invoked from news.daily(8), which handles such
       things as processing the rmfile and lowmarkfile if necessary.  Some‐
       times it's convenient to manually expire a particular newsgroup, how‐
       ever.  This can be done with a command like:

	   echo example.test ⎪ expireover -f - -Z /usr/local/news/tmp/lowmark
	   ctlinnd lowmark /usr/local/news/tmp/lowmark

       This can be particularly useful if a lot of articles in a particular
       group have expired but the overview information is still present, caus‐
       ing some clients to see a lot of "this article may have been cancelled"
       messages when they first enter the newsgroup.

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.

       $Id: expireover.8 5912 2002-12-03 05:31:11Z vinocur $

SEE ALSO
       active(5), ctlinnd(8), expire(8), expire.ctl(5), inn.conf(5),
       news.daily(8).

INN 2.4.0			  2002-12-03			 EXPIREOVER(8)
[top]

List of man pages available for YellowDog

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