git-annex-find - lists available files
git annex find [path ...]
Outputs a list of annexed files in the specified path. With no
path, finds files in the current directory and its subdirectories.
- matching
options
- The git-annex-matching-options(1) can be used to specify files to
list.
- By default, the find command only lists annexed files whose content is
currently present. Specifying any of the matching options will override
this default behavior.
- To list all annexed files, present or not, specify --include
"*".
- To list annexed files whose content is not present, specify --not
--in=here
- --branch=ref
- List files in the specified branch or treeish.
- --print0
- Output filenames terminated with nulls, for use with xargs -0
- --format=value
- Use custom output formatting.
- The value is a format string, in which '${var}' is expanded to the value
of a variable. To right-justify a variable with whitespace, use
'${var;width}' ; to left-justify a variable, use '${var;-width}'; to
escape unusual characters in a variable, use '${escaped_var}'
- These variables are available for use in formats: file, key, backend,
bytesize, humansize, keyname, hashdirlower, hashdirmixed, mtime (for the
mtime field of a WORM key).
- Also, '\n' is a newline, '\000' is a NULL, etc.
- The default output format is the same as --format='${file}\n'
- --json
- Output the list of files in JSON format.
- This is intended to be parsed by programs that use git-annex. Each line of
output is a JSON object.
- --json-error-messages
- Messages that would normally be output to standard error are included in
the json instead.
- --batch
- Enables batch mode, in which a file is read in a line from stdin, its
information displayed, and repeat.
- Note that if the file is not an annexed file, or is not present, or
otherwise doesn't meet the matching options, an empty line will be output
instead.
- -z
- Makes the --batch input be delimited by nulls instead of the usual
newlines.
Joey Hess <id@joeyh.name>