GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DIRVISH-EXPIRE (8)

NAME

dirvish-expire - delete expired dirvish images

CONTENTS

Synopsis
Description
Options
Exit Codes
Files
See Also
Bugs

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

.B --tree Only delete the image tree, leave in place the rest of the image directory with summary, log and any other image administrative files.
.BI --vault " vault"
  Restrict expiration to the specified vault.
.B --no-run Don’t actually do anything. Just display what would have happened.
.B --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.
Search for    or go to Top of page |  Section 8 |  Main Index


DIRVISH-EXPIRE (8) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.