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 happened.

       --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 severe 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 specified vault looking for summary files.  Anything non-dirvish  in  there
       may cause excess file-walking.

																 DIRVISH-EXPIRE(8)