a4a5ec6366
Thanks to previous work in 11cc9f1933,
this is almost entirely free, it only needs to do some additional map
lookups and math.
The strictness annotations keep the memory use from blowing up.
Sponsored-by: unqueued on Patreon
99 lines
2.7 KiB
Markdown
99 lines
2.7 KiB
Markdown
# 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.
|