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

FreeBSD Manual Pages

  
 
  

home | help 
DIRVISH-EXPIRE(8)	    System Manager's Manual	     DIRVISH-EXPIRE(8)

NAME
       dirvish-expire -	delete expired dirvish images

SYNOPSIS
       dirvish-expire[OPTIONS]

DESCRIPTION
       Delete dirvish image trees or whole images that have expired.

       Each  image  summary  file  is  checked for the Expire: field.  If that
       field indicates the image has expired dirvish-expire will  delete  that
       image from the vault.

       By  default  all	 subdirectories	of all banks will be treated as	vaults
       and all directories therein  except  the	 one  named  dirvish  will  be
       checked for summary files.

       The removal of an image will have no effect on other images.

       Dirvish-expire  will  not  delete an image unless it finds at least one
       image in	that branch that has an	intact image tree and Status:  success
       in the summary that is not expired.

OPTIONS
       Each  option  on	the command line may be	specified any number of	times.
       Those options that support lists	in the config  files  will  accumulate
       all  of	their arguments	otherwise each specification will override the
       ones before.

       Each option may be unambiguously	abbreviated.

       --time time_expression
	      Execute as though	time_expression	were the current time.

	      Time_expression is processed by Time::Parsedate(3pm) so relative
	      time and date strings are	permitted.   See  Time::Parsedate(3pm)
	      for more details.

       --tree Only delete the image tree, leave	in place the rest of the image
	      directory	 with  summary,	log and	any other image	administrative
	      files.

       --vault vault
	      Restrict expiration to the specified vault.

       --no-run
	      Don't actually do	anything.  Just	display	what would  have  hap-
	      pened.

       --quiet
	      Run quietly, only	report errors.

	      Normally dirvish-expire will report the images deleted.

EXIT CODES
       To facilitate further automation	and integration	of dirvish-expire with
       other  tools dirvish-expire provides rationalised exit codes.  The exit
       codes are range based.  While the code for a specific error may	change
       from  one version to another it will remain within the specified	range.
       So don't	test for specific exit codes but instead test for a  range  of
       values.	 To  the degree	possible higher	value ranges indicate more se-
       vere errors.

       0      success

       200-219
	      An error was encountered in loading a configuration file.

       220-254
	      An error was detected in the configuration.

       255    Incorrect	usage.

FILES
       /etc/dirvish/master.conf
	      alternate	master configuration file.

       /etc/dirvish.conf
	      master configuration file.

       bank/vault/image/summary
	      image creation summary.

       bank/vault/image/tree
	      actual image of source directory tree.

SEE ALSO
       dirvish.conf(5)
       Time::ParseDate(3pm)

BUGS
       Dirvish-expire will walk	the file hierarchy of all banks	or the	speci-
       fied  vault  looking  for summary files.	 Anything non-dirvish in there
       may cause excess	file-walking.

							     DIRVISH-EXPIRE(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dirvish-expire&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help