NAME

       git-annex-find - lists available files

SYNOPSIS

       git annex find [path ...]

DESCRIPTION

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

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.

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

SEE ALSO

       git-annex(1)

       git-annex-whereis(1)

       git-annex-list(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                git-annex-find(1)