git-annex-log - shows location log information
This command displays information from the history of the
git-annex branch.
Several things can prevent that information being available to
display. When git-annex-forget is used, old historical data gets cleared
from the branch. When annex.private or remote.name.annex-private is
configured, git-annex does not write information to the branch at all. And
when annex.alwayscommit is set to false, information may not have been
committed to the branch yet.
- [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 git log, and can be used to
limit how far back to search for location log changes.
- For example: --since "1 month ago"
- 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.
git-annex(1)
git-annex-forget(1)
Joey Hess <id@joeyh.name>