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

              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
              (including control 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',  except when
              outputting to a terminal, control characters will be escaped.

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

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

SEE ALSO

       git-annex(1)

       git-annex-whereis(1)

       git-annex-findkeys(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                git-annex-find(1)