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 (including control
43              characters) in a variable, use '${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              except when outputting to a terminal, control characters will be
53              escaped.
54
55       --json Output the list of files in JSON format.
56
57              This is intended to be parsed by programs  that  use  git-annex.
58              Each line of output is a JSON object.
59
60       --json-error-messages
61              Messages that would normally be output to standard error are in‐
62              cluded in the JSON instead.
63
64       --batch
65              Enables batch mode, in which a file  is  read  in  a  line  from
66              stdin, its information displayed, and repeat.
67
68              Note that if the file is not an annexed file, or is not present,
69              or otherwise doesn't meet the matching options,  an  empty  line
70              will be output instead.
71
72       -z     Makes  the  --batch  input  be delimited by nulls instead of the
73              usual newlines.
74
75       Also the git-annex-common-options(1) can be used.
76

SEE ALSO

78       git-annex(1)
79
80       git-annex-whereis(1)
81
82       git-annex-findkeys(1)
83

AUTHOR

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