NAME

git-annex info - information about an item or the repository

SYNOPSIS

git annex info [directory|file|treeish|remote|description|uuid ...]

DESCRIPTION

Displays statistics and other information for the specified item.

When no item is specified, displays overall information. This includes a list of all known repositories, how much annexed data is present in the local repository, the total size of all annexed data in the working tree, the combined size of annexed data in all repositories, and the annex sizes of each repository.

When a directory is specified, displays information about the annexed files in that directory (and subdirectories). This includes how much annexed data is present in the local repository, the total size of all annexed data in the directory, how many files have the specified numcopies or more (+1, +2 etc) or less (-1, -2 etc), and information about how much of the annexed data is stored in known repositories.

When a treeish is specified, displays similar information as when a directory is specified, but about the annexed files in that treeish.

When a remote, or description of a repository, or uuid is specified, displays information about the specified repository, including the total amount of annexed data stored in it, and a variety of configuration information.

OPTIONS

  • --fast

    Only show the information that can be gathered quickly.

  • --json

    Enable JSON output. 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.

  • --bytes

    Show file sizes in bytes, disabling the default nicer units.

  • --batch

    Enable batch mode, in which a line containing an item is read from stdin, the information about it is output to stdout, and repeat.

  • -z

    Makes the --batch input be delimited by nulls instead of the usual newlines.

  • --autoenable

    Display a list of special remotes that have been configured to autoenable.

  • --dead-repositories

    Display a list of repositories that have been marked as dead. Such repositories are not displayed in other info displays.

  • matching options

    The git-annex-matching-options(1) can be used to select what to include in the statistics.

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

EXAMPLES

Suppose you want to run "git annex get .", but would first like to see how much disk space that will use. Then run:

git annex info --fast . --not --in here

SEE ALSO

git-annex(1)

AUTHOR

Joey Hess id@joeyh.name

Warning: Automatically converted into a man page by mdwn2man. Edit with care.