1git-annex-whereis(1)        General Commands Manual       git-annex-whereis(1)
2
3
4

NAME

6       git-annex-whereis - lists repositories that have file content
7

SYNOPSIS

9       git annex whereis [path ...]
10

DESCRIPTION

12       Displays information about where the contents of files are located.
13
14       For example:
15
16        # git annex whereis
17        whereis my_cool_big_file (1 copy)
18            0c443de8-e644-11df-acbf-f7cd7ca6210d  -- laptop
19        whereis other_file (3 copies)
20            0c443de8-e644-11df-acbf-f7cd7ca6210d  -- laptop
21            62b39bbe-4149-11e0-af01-bb89245a1e61  -- usb drive [here]
22            7570b02e-15e9-11e0-adf0-9f3f94cb2eaa  -- backup drive
23
24       Note that this command does not contact remotes to verify if they still
25       have the content of files. It only reports on the last information that
26       was received from remotes.
27

OPTIONS

29       file matching options
30
31              The  git-annex-matching-options(1)  can be used to specify files
32              to act on.
33
34       --key=keyname
35              Show where a particular git-annex key is located.
36
37       --all -A
38              Show whereis information for all known keys.
39
40       --branch=ref
41              Show whereis information for files in the  specified  branch  or
42              treeish.
43
44       --unused
45              Show  whereis  information  for  files found by last run of git-
46              annex unused.
47
48       --batch
49              Enables batch mode, in which a file  is  read  in  a  line  from
50              stdin, its information displayed, and repeat.
51
52              Note  that if the file is not an annexed file, or does not match
53              specified file matching options, an empty line  will  be  output
54              instead.
55
56       -z     Makes  the  --batch  input  be delimited by nulls instead of the
57              usual newlines.
58
59       --json Enable JSON output. This is intended to be  parsed  by  programs
60              that use git-annex. Each line of output is a JSON object.
61
62       --json-error-messages
63              Messages  that  would  normally  be output to standard error are
64              included in the json instead.
65
66       --format=value
67              Use custom output formatting.
68
69              The value is a format string, in which '${var}' is  expanded  to
70              the value of a variable. To right-justify a variable with white‐
71              space, use '${var;width}' ;  to  left-justify  a  variable,  use
72              '${var;-width}'; to escape unusual characters in a variable, use
73              '${escaped_var}'
74
75              These variables are available for use  in  formats:  file,  key,
76              uuid,  url, backend, bytesize, humansize, keyname, hashdirlower,
77              hashdirmixed, mtime (for the mtime field of a WORM key).
78
79              Also, '\n' is a newline, '\000' is a NULL, etc.
80
81              When the format contains the uuid variable, it will be  expanded
82              in  turn for each repository that contains the file content. For
83              example, with --format="${file}  ${uuid}\n",  output  will  look
84              like:
85
86               foo 00000000-0000-0000-0000-000000000001
87               foo a7f7ddd0-9a08-11ea-ab66-8358e4209d30
88               bar a7f7ddd0-9a08-11ea-ab66-8358e4209d30
89
90              The  same  applies  when the url variable is used and a file has
91              multiple recorded urls.
92

SEE ALSO

94       git-annex(1)
95
96       git-annex-find(1)
97
98       git-annex-list(1)
99

AUTHOR

101       Joey Hess <id@joeyh.name>
102
103                                                          git-annex-whereis(1)
Impressum