dirvish-locate - locate file versions in dirvish images
dirvish-locate vault[:branch] pattern
Locate versions of files in a dirvish vault
The index of each image specified vault
is searched for paths matching
. Each path found matching the pattern
will be reported
followed by a modification time of each version of the file and all images
having a link to it.
The optional branch
specification will restrict searching to the
Images with an error status will be skipped as will any without index files. The
index file may be compressed by gzip or bzip2. See tree
is a perl
regular expression to match the final
component of the path. Append .*
to the end of the pattern if you wish
to match any substring of the whole path or $
if you wish to anchor the
pattern to the end of the path. See perlre(1)
Directories are excluded from matching as they would wind up matching every file
within them anyway. Symlinks are also excluded from matching.
If the pattern
matches too many paths dirvish-locate
report the paths matched and not versions. As a sanity check if the number of
matches is really excessive dirvish-locate
will limit the number of
images searched. Excessive matches is an indication of an insufficiently
. Use the resulting path list to compose a more
To facilitate further automation and integration of dirvish-locate
other tools dirvish-locate provides rationalised exit codes.
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.
- success 200-219 An error was encountered in loading a
- An error was detected in the configuration.
- Incorrect usage.
- alternate master configuration file.
- master configuration file.
- image creation summary.
- dirvish index file.