git-annex-find






git‐annex‐find − lists available files


git annex find [path ...]


Outputs a list of annexed files in the specified path. With
no path, finds files in the current directory and its
subdirectories.




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


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











                             ‐2‐


     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.


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


git‐annex(1)

     git‐annex−whereis(1)

     git‐annex−list(1)


Joey Hess <id@joeyh.name>