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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT CODES | FILES | SEE ALSO | BUGS

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

home | help