1DIRVISH-LOCATE(8)           System Manager's Manual          DIRVISH-LOCATE(8)
2
3
4

NAME

6       dirvish-locate - locate file versions in dirvish images
7

SYNOPSIS

9       dirvish-locate vault[:branch] pattern
10

DESCRIPTION

12       Locate versions of files in a dirvish vault
13
14       The  index of each image specified vault is searched for paths matching
15       pattern.  Each path found matching the pattern will  be  reported  fol‐
16       lowed by a modification time of each version of the file and all images
17       having a link to it.
18
19       The optional branch specification will restrict searching to the speci‐
20       fied branch.
21
22       Images  with  an error status will be skipped as will any without index
23       files.  The index file may be compressed by gzip or  bzip2.   See  tree
24       and index in dirvish.conf(5) for details.
25
26       The  pattern  is a perl regular expression to match the final component
27       of the path.  Append .*  to the end of the pattern if you wish to match
28       any  substring of the whole path or $ if you wish to anchor the pattern
29       to the end of the path.  See perlre(1) for details.
30
31       Directories are excluded from matching as they would wind  up  matching
32       every  file within them anyway.  Symlinks are also excluded from match‐
33       ing.
34
35       If the pattern matches too many paths dirvish-locate will  only  report
36       the paths matched and not versions.  As a sanity check if the number of
37       matches is really excessive dirvish-locate will  limit  the  number  of
38       images  searched.   Excessive  matches  is an indication of an insuffi‐
39       ciently specific pattern.  Use the resulting path  list  to  compose  a
40       more specific one.
41

EXIT CODES

43       To facilitate further automation and integration of dirvish-locate with
44       other tools dirvish-locate provides rationalised exit codes.  The  exit
45       codes  are range based.  While the code for a specific error may change
46       from one version to another it will remain within the specified  range.
47       So  don't  test for specific exit codes but instead test for a range of
48       values.  To the degree  possible  higher  value  ranges  indicate  more
49       severe errors.
50
51       0      success 200-219 An error was encountered in loading a configura‐
52              tion file.
53
54       220-254
55              An error was detected in the configuration.
56
57       255    Incorrect usage.
58

FILES

60       /etc/dirvish/master.conf
61              alternate master configuration file.
62
63       /etc/dirvish.conf
64              master configuration file.
65
66       bank/vault/image/summary
67              image creation summary.
68
69       bank/vault/image/index
70
71       bank/vault/image/index.gz
72
73       bank/vault/image/index.bz2
74              dirvish index file.
75

SEE ALSO

77       dirvish.conf(5)
78

BUGS

80                                                             DIRVISH-LOCATE(8)
Impressum