Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DEXPIRE(8)		    System Manager's Manual		    DEXPIRE(8)

NAME
       dexpire - Diablo	program	to expire article files

SYNOPSIS
       dexpire	-a|n [ -c0 ] [ -h0|1 ] [ -k ] [	-n ] [ -O[n] ] [ -o ] [	-q ] [
       -R nn:# ] [ -Snn	] [ -s[#[:#]] ]	[ -u ] [ -v ] [	-z ] [ -C  diablo.con-
       fig ] [ -d[n] ] [ -V ]

DESCRIPTION
       DExpire	does an	expire run on the history file,	removing expired arti-
       cles and	updating (but not rewriting) the history file as  appropriate.
       DExpire	operates  in  a	 FIFO  manner, removing	the oldest spool files
       first.  It will remove spool directories	one at a time until one	of the
       expire  targets specified in dspool.ctl is reached. This	process	is run
       for each	spool object and repeatedly until  all	requirements  for  all
       spools are met.

       -a

       This  option  tells dexpire to actually remove files. The default is to
       just print the usage if no other	options	are used or to make no updates
       if they are. This options is required to	actually do any	expire work.

       -c0

       Tell dexpire to not perform the file removal pass. i.e: Nothing will be
       done unless the ``-h1'' option is used, in which	case only the  history
       update will be done to expire entries not found on the spool.

       -h0|1

       Tell  DExpire  to  *not*	update or to forcibly update the history file.
       The default is to only update the history files if directories were re-
       moved.	The  ``-h0''  option  can  be used to run dexpire on a tighter
       scheduler, such as once an hour,	without	having to eat the overhead  of
       updating	 the history file (the overhead	is not significant, unless you
       have a really big history file).	 You should still run dexpire normally
       at  least  four times a day, though.  The ``-h1'' option	can be used to
       forcibly	update the history file, even if no directories	 were  removed
       by  dexpire. This can be	useful if you have another program/script that
       removes directories, or if you do it by hand.

       -k

       This option tells dexpire to not	make any actual	changes	to the history
       entries	even  if  we need to do	so. It is useful to get	an estimate of
       how much	time a history update will take, without actually  making  the
       individual updates.

       -n

       This option tells dexpire to run	through, but not make any updates.  It
       useful for testing what a set of	options	will do	and  a	status	report
       will be printed (unless disabled	with ``-q''). This is the default.

       -O[n]  This option specifies the	number of iterations to	run before ex-
       iting. The default is to	run until all space/age	requirements  for  all
       spools  are  met,  which	 means	you  could have	a long running dexpire
       process if the rate of incoming articles	exceeds	the rate at which dex-
       pire  can remove	old articles. If no number is specified, a single dex-
       pire pass is made.

       -o

       Tell dexpire to write the expired message IDs to	a file for  later  use
       by dexpireover when expiring overview information. Writes to file spec-
       ified by	 path_dexpover_list  in	 diablo.config,	 defaults  to  %s/dex-
       pover.dat, path_db based.

       -q

       Be  less	verbose	about what is happening. The default is	to give	a sta-
       tus report on what is being done	to stdout.

       -R nn:#

       This option allows you to specify a free	space target  (in  MB)	for  a
       particular  spool  object.  This	 will  override	 the  same  option  in
       dspool.ctl or peform  a	check  if  the	option	is  not	 specified  in
       dspool.ctl. The parameters are ``spool_number:target''.

       -S nn

       This  option  is	used to	limit which spool objects dexpire works	on. It
       can be used to reduce memory requirements and run multiple,  concurrent
       instances of dexpire on different spools.

       -s[#]

       This  option tells dexpire that it is expiring on a softupdates-mounted
       filesystem and that it needs to	sync/sleep/sync/sleep  after  removing
       each directory in order for statfs() to return reasonable values.   The
       sleep time inbetween sync's may be specified.  If no number  is	speci-
       fied,  a	 sleep of 1 is used.  -s2 is suggested for softupdates-mounted
       partitions.  If the sleep time has :10 appended,	the  sync's  are  only
       done  after that	number of filesystems space checks (usually after that
       number of file deletes).

       -u This option marks all	expired	entries	in dhistory as	unexpired.  It
       should  not  be used with other options (except '-a', which is required
       if changes are to be made). Note	that  the  articles  will  be  expired
       again  during  the next normal dexpire run. The option is useful	in the
       case of accidently expired articles (possibly due to a bug).

       -v This option turns on verbose mode.

       -z This option is used to specify that dexpire should  only  check  the
       filesystem  free	 space	(if required) once through each	iteration.  By
       default,	dexpire	checks during the initial scan and after removing each
       directory.  This	 could	be  a slight performance win on	systems	with a
       slow statfs().

       -C allows the specification of the path of the  diablo.config  file  to
       use.

       -d[n] will set debug mode, at optional level n.

       -V will print the version and exit.

       After  clearing	out sufficient disk space, DExpire will	scan the spool
       directory and then update the history file in  place.   This  is	 rela-
       tively  self  repairing,	so you can remove spool	files manually without
       getting things out of synch.  However, to be completely safe you	should
       rename  a  D.xxxxxxxx directory to A.xxxxxxxx prior to rm -rf'ing it if
       diablo is running.

       -s[#]

       Tell dexpire to be more verbose (this is	the default).

       -d[#]

       Turn on debugging. The higher the number	specified,  the	 more  verbose
       the debugging messages.

SEE ALSO
       diablo(8), dicmd(8), didump(8), diload(8), dnewslink(8),	doutq(8), dex-
       pire(8),	 dexpireover(8),  diconvhist(8),  dilookup(8),	 dspoolout(8),
       dkp(8), dpath(8), diablo-kp(5), diablo-files(5)

								    DEXPIRE(8)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dexpire&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help