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

EXPIRE(8)							     EXPIRE(8)

NAME
       expire - Usenet article and history expiration program

SYNOPSIS
       expire  [  -d dir ] [ -f file ] [ -g file ] [ -h file ] [ -i ] [ -l ] [
       -n ] [ -p ] [ -q ] [ -r reason ] [ -s ] [ -t ] [ -v level ] [ -w number
       ] [ -x ] [ -z file ] [ expire.ctl ]

DESCRIPTION
       Expire  scans the history(5) text file /var/spool/news/data/history and
       uses the information recorded in it to purge  old  news	articles.   To
       specify	an alternate history file, use the ``-f'' flag.	 To specify an
       alternate input text history file, use the ``-h''  flag.	  Expire  uses
       the  old	 dbz(3z)  database  to	determine the size of the new one.  To
       ignore the old database, use the ``-i'' flag.

       Expire normally just unlinks each file if it should be expired.	If the
       ``-l''  flag is used, then all articles after the first one are treated
       as if they could be symbolic links to the first one.  In this case, the
       first  article  will not be removed as long as any other cross-posts of
       the article remain.

       Expire normally sends a ``pause'' command to the local  innd(8)	daemon
       when  it	 needs	exclusive access to the history file, using the string
       ``Expiring'' as the reason.  To give a different reason, use the ``-r''
       flag.   The  process ID will be appended to the reason.	When expire is
       finished and the new history file is ready, it sends a ``go''  command.
       If  innd	 is  not running, use the ``-n'' flag and expire will not send
       the ``pause'' or ``go'' commands.  (For more details on	the  commands,
       see  ctlinnd(8)).   Note	 that expire only needs exclusive access for a
       very short time — long enough to see if any new articles arrived	 since
       it  first  hit  the end of the file, and to rename the new files to the
       working files.

       If the ``-s'' flag is used, then expire will print a  summary  when  it
       exits  showing  the approximate number of kilobytes used by all deleted
       articles.

       If the ``-t'' flag is used, then expire will generate  a	 list  of  the
       files  that  should be removed on its standard output, and the new his‐
       tory file  will	be  left  in  history.n	 and  history.n.dir  and  his‐
       tory.n.pag.   This  flag	 be  useful  for  debugging when used with the
       ``-n'' and ``-s'' flags.	 Note that if the ``-f'' flag  is  used,  then
       the name specified with that flag will be used instead of history.

       If the ``-x'' flag is used, then expire will not create any new history
       files.  This is most useful when combined with the ``-n'', ``-s'',  and
       ``-t''  flags to see how different expiration policies would change the
       amount of disk space used.

       If the ``-z'' flag is used, then articles are not  removed,  but	 their
       names are written to the specified file.	 See the description of expir‐
       erm in news.daily(8).

       Expire makes its decisions on the time the article arrived, as found in
       the  history  file.  This means articles are often kept a little longer
       than with other expiration programs that base their  decisions  on  the
       article's  posting  date.   To  use the article's posting date, use the
       ``-p'' flag.  Use the ``-w'' flag  to  ``warp''	time  so  that	expire
       thinks  it  is  running	at some time other then the current time.  The
       value should be a signed floating point number of the number of days to
       use as the offset.

       If  the	``-d'' flag is used, then the new history file and database is
       created in the specified directory,  dir.   This	 is  useful  when  the
       filesystem  does not have sufficient space to hold both the old and new
       history files.  When this flag is used, expire leaves the server paused
       and  creates  a zero-length file named after the new history file, with
       an extension of ``.done'' to indicate that  it  has  successfully  com‐
       pleted  the expiration.	The calling script should install the new his‐
       tory file and un-pause the server.  The ``-r'' flag should be used with
       this flag.

       If  a filename is specified, it is taken as the control file and parsed
       according to the rules in expire.ctl(5).	 A single dash (``-'') may  be
       used  to	 read  the file from standard input.  If no file is specified,
       the file /var/spool/news/data/expire.ctl is read.

       Expire normally complains about articles that are posted to  newsgroups
       not  mentioned  in  the	active file.  To suppress this action, use the
       ``-q'' flag.

       The ``-v'' flag is used to increase the verbosity of the program,  gen‐
       erating	messages  to  standard	output.	 The level should be a number,
       where higher numbers result in  more  output.   Level  one  will	 print
       totals  of the various actions done (not valid if a new history file is
       not written), level two will print  report  on  each  individual	 file,
       while level five results in more than one line of output for every line
       processed.  If the ``-g'' flag is given, then a one-line summary equiv‐
       alent  to the output of ``-v1'' and preceeded by the current time, will
       be appended to the specified file.

HISTORY
       Written by Rich $alz <rsalz@uunet.uu.net> for  InterNetNews.   This  is
       revision 1.15, dated 1993/03/18.

SEE ALSO
       ctlinnd(8), dbz(3z), expire.ctl(5), history(5), innd(8), inndcomm(3).

								     EXPIRE(8)
[top]

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