11cc9f1933
Factored out overLocationLogs from CmdLine.Seek, which can calculate this pretty fast even in a large repo. In my big repo, the time to run git-annex info went up from 1.33s to 8.5s. Note that the "backend usage" stats are for annexed files in the working tree only, not all annexed files. This new data source would let that be changed, but that would be a confusing behavior change. And I cannot retitle it either, out of fear something uses the current title (eg parsing the json). Also note that, while time says "402108maxresident" in my big repo now, up from "54092maxresident", top shows the RES constant at 64mb, and it was 48mb before. So I don't think there is a memory leak. I tried using deepseq to force full evaluation of addKeyCopies and memory use didn't change, which also says no memory leak. And indeed, not even calling addKeyCopies resulted in the same memory use. Probably the increased memory usage is buffering the stream of data from git in overLocationLogs. Sponsored-by: Brett Eisenberg on Patreon
98 lines
2.6 KiB
Markdown
98 lines
2.6 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, and the combined size of all annexed data in all known repositories.
|
|
|
|
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.
|