574514545c
This can take a lot of memory. I decided to violate the usual rule in git-annex that it operate in constant memory no matter how many annexed objects. In this case, it would be hard to be fast without using a big map of the location logs. The main difficulty here is that there can be many git-annex branches and it needs to display a consistent view at a point in time, which means merging information from multiple git-annex branches. I have not checked if there are any laziness leaks in this code. It takes 1 gb to run in my big repo, which is around what I estimated before writing it. 2 options that are documented are not yet implemented. Small bug: With eg --when=1h, it will display at 12:00 then 1:10 if the next change after 12:59 is then. Then it waits until after 2:10 to display the next change. It ought to wait until after 2:00. Sponsored-by: Brock Spratlen 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, and the total size of all annexed data in the working
|
|
tree.
|
|
|
|
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.
|