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)