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

       --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.

       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

SEE ALSO

       git-annex(1)

       git-annex-whereis(1)

       git-annex-list(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                git-annex-find(1)