|.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||Dont actually do anything. Just display what would have happened.|
Run quietly, only report errors.
Normally dirvish-expire will report the images deleted.
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 dont 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.
/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.
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.