Man Linux: Main Page and Category List


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

       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

       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.


              alternate master configuration file.

              master configuration file.

              image creation summary.



              dirvish index file.