git-annex-find(1)           General Commands Manual          git-annex-find(1)

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)