NAME

SYNOPSIS

DESCRIPTION

OPTIONS

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.

--batch-keys

This is like --batch but the lines read from stdin are parsed as keys.

-z

Makes the --batch input be delimited by nulls instead of the usual newlines.

Also the git-annex-common-options(1) can be used.

SEE ALSO

git-annex-whereis(1)

git-annex-list(1)

AUTHOR