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

NAME

6       git-annex-find - lists available files
7

SYNOPSIS

9       git annex find [path ...]
10

DESCRIPTION

12       Outputs  a  list  of annexed files in the specified path. With no path,
13       finds files in the current directory and its subdirectories.
14

OPTIONS

16       matching options
17
18              The git-annex-matching-options(1) can be used to  specify  files
19              to list.
20
21              By default, the find command only lists annexed files whose con‐
22              tent is  currently  present.  Specifying  any  of  the  matching
23              options will override this default behavior.
24
25              To  list  all  annexed  files, present or not, specify --include
26              "*".
27
28              To list annexed files whose  content  is  not  present,  specify
29              --not --in=here
30
31       --print0
32              Output filenames terminated with nulls, for use with xargs -0
33
34       --format=value
35              Use custom output formatting.
36
37              The  value  is a format string, in which '${var}' is expanded to
38              the value of a variable. To right-justify a variable with white‐
39              space,  use  '${var;width}'  ;  to  left-justify a variable, use
40              '${var;-width}'; to escape unusual characters in a variable, use
41              '${escaped_var}'
42
43              These  variables  are  available  for use in formats: file, key,
44              backend,    bytesize,    humansize,    keyname,    hashdirlower,
45              hashdirmixed, mtime (for the mtime field of a WORM key).
46
47              Also, '\n' is a newline, '\000' is a NULL, etc.
48
49              The default output format is the same as --format='${file}\n'
50
51       --json Output the list of files in JSON format.
52
53              This  is  intended  to be parsed by programs that use git-annex.
54              Each line of output is a JSON object.
55
56       --json-error-messages
57              Messages that would normally be output  to  standard  error  are
58              included in the json instead.
59
60       --batch
61              Enables  batch  mode,  in  which  a  file is read in a line from
62              stdin, its information displayed, and repeat.
63
64              Note that if the file is not an annexed file, or is not present,
65              or  otherwise  doesn't  meet the matching options, an empty line
66              will be output instead.
67
68       -z     Makes the --batch input be delimited by  nulls  instead  of  the
69              usual newlines.
70

SEE ALSO

72       git-annex(1)
73
74       git-annex-whereis(1)
75
76       git-annex-list(1)
77

AUTHOR

79       Joey Hess <id@joeyh.name>
80
81                                                             git-annex-find(1)