OnWorks favicon

dirvish-locate - Online in the Cloud

Run dirvish-locate in OnWorks free hosting provider over Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator

This is the command dirvish-locate that can be run in the OnWorks free hosting provider using one of our multiple free online workstations such as Ubuntu Online, Fedora Online, Windows online emulator or MAC OS online emulator



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 pattern. 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 specified branch.

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 and index in dirvish.conf(5) for

The pattern 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) for details.

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 will only 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 specific pattern. Use the resulting path list to compose
a more specific one.


To facilitate further automation and integration of dirvish-locate with other tools
dirvish-locate 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.

An error was detected in the configuration.

255 Incorrect usage.

Use dirvish-locate online using onworks.net services

Free Servers & Workstations

Download Windows & Linux apps

Linux commands