xenial (1) git-annex-find.1.gz

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)