# NAME

git-annex log - shows location log information

# SYNOPSIS

git annex log `[path ...]`

# DESCRIPTION

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.

# OPTIONS

* `[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.

# SEE ALSO

[[git-annex]](1)

[[git-annex-forget]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.