git-annex-find

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