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

SEE ALSO

76       git-annex(1)
77
78       git-annex-whereis(1)
79
80       git-annex-findkeys(1)
81

AUTHOR

83       Joey Hess <id@joeyh.name>
84
85                                                             git-annex-find(1)
Impressum