NAME

       git-annex-findkeys - lists available keys

SYNOPSIS

       git annex findkeys

DESCRIPTION

       Outputs a list of keys known to git-annex.

OPTIONS

       matching options

              The git-annex-matching-options(1) can be used to specify which keys to list.

              By  default,  the  findkeys  command  only  lists  keys  whose content is currently
              present. Specifying any of the matching options will override this default behavior
              and match on all keys that git-annex knows about.

              To list all keys, present or not, specify --anything.

              To list keys whose content is not present, specify --not --in=here

       --print0
              Output keys 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:  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='${escapedkey}\n'  except  when
              outputting to a terminal, control characters will be escaped.

       --json Output the list of keys 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.

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

SEE ALSO

       git-annex(1)

       git-annex-find(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                            git-annex-findkeys(1)