[path...]
Displays the location log for the specified file or files, showing each repository they were added
to ("+") and removed from ("-"). Note that it displays information about the file content
currently at these paths, not for any different content that was there in earlier commits.
matching options
The git-annex-matching-options(1) can be used to control what to act on when displaying the
location log for specified files.
--all-A
Shows location log changes to all content, with the most recent changes first. In this mode, the
names of files are not available and keys are displayed instead.
--sizesof=repository
Displays a history of the total size of the annexed files in a repository over time from the
creation of the repository to the present.
The repository can be "here" for the current repository, or the name of a remote, or a repository
description or uuid.
Note that keys that do not have a known size are not included in the total.
--sizes
This is like --sizesof, but rather than display the size of a single repository, it displays the
sizes of all known repositories.
The output is a CSV formatted table.
--totalsizes
This is like --sizesof, but it displays the total size of all known repositories.
--interval=time
When using --sizesof, --sizes, and --totalsizes, this controls the minimum interval between
displays of the size. The default is to display each new recorded size.
The time is of the form "30d" or "1y".
--received
Combine this option with --sizesof or --sizes to display the amount of data received into
repositories since the last line was output.
--gnuplot
Combine this option with --sizesof or --sizes or --totalsizes to use gnuplot(1) to graph the data.
The gnuplot file will be left on disk for you to reuse.
For example, to graph the sizes of all repositories:
git-annex log --sizes --interval=1d --gnuplot
To graph the amount of new data received into each repository every 30 days:
git-annex log --sizes --interval=30d --gnuplot --recieved
--bytes
Show sizes in bytes, disabling the default nicer units.
--raw-date
Rather than the normal display of a date in the local time zone, displays seconds since the unix
epoch.
--since=date, --after=date, --until=date, --before=date, --max-count=N
These options are passed through to gitlog, and can be used to limit how far back to search for
location log changes.
For example: --since"1monthago"
These options do not have an affect when using --sizesof, --sizes, and --totalsizes.
--gource
Generates output suitable for the gource visualization program.
This option does not have an affect when using --sizesof, --sizes, and --totalsizes.
--json Enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of
output is a JSON object.
This option does not have an affect when using --sizesof, --sizes, and --totalsizes.
--json-error-messages
Messages that would normally be output to standard error are included in the JSON instead.
This option does not have an affect when using --sizesof, --sizes, and --totalsizes.
Also the git-annex-common-options(1) can be used.