alexvanin/restic
1
0
Fork 0
forked from TrueCloudLab/restic
Code Pull requests Activity

Merge pull request #1315 from prattmic/cache_doc

Browse source 
Clarify cache location documentation
This commit is contained in:
Alexander Neumann 2017-10-03 12:36:53 +02:00
commit 216e374310
2 changed files with 14 additions and 10 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

8
CHANGELOG.md
View file

@ -7,10 +7,10 @@ Important Changes in 0.X.Y
* We've added a local cache for metadata so that restic doesn't need to load * We've added a local cache for metadata so that restic doesn't need to load
all metadata (snapshots, indexes, ...) from the repo each time it starts. By all metadata (snapshots, indexes, ...) from the repo each time it starts. By
default the cache is active, but there's a new global option `--no-cache` default the cache is active, but there's a new global option `--no-cache`
that can be used to disable the cache. The cache location is that can be used to disable the cache. By deafult, the cache a standard
`~/.cache/restic` by default, which can be overridden with `--cache-dir` or cache folder for the OS, which can be overridden with `--cache-dir`. The
the environment variable `XDG_CACHE_HOME`. The cache will automatically cache will automatically populate, indexes and snapshots are saved as they
populate, indexes and snapshots are saved as they are loaded. are loaded.
https://github.com/restic/restic/pull/1040 https://github.com/restic/restic/pull/1040
https://github.com/restic/restic/issues/29 https://github.com/restic/restic/issues/29
https://github.com/restic/restic/issues/738 https://github.com/restic/restic/issues/738

16
doc/manual_rest.rst
View file

@ -267,12 +267,16 @@ Caching
Restic keeps a cache with some files from the repository on the local machine. Restic keeps a cache with some files from the repository on the local machine.
This allows faster operations, since meta data does not need to be loaded from This allows faster operations, since meta data does not need to be loaded from
a remote repository. The cache is automatically created, usually in the a remote repository. The cache is automatically created, usually in an
directory ``.cache/restic`` in the user's home directory. The environment OS-specific cache folder:
variable ``XDG_CACHE_DIR`` or the command line parameter ``--cache-dir`` can
each be used to specify where the cache is located. The parameter * Linux/other: ``~/.cache/restic`` (or ``$XDG_CACHE_HOME/restic``)
``--no-cache`` disables the cache entirely. In this case, all data is loaded * macOS: ``~/Library/Caches/restic``
from the repo. * Windows: ``%LOCALAPPDATA%/restic``
The command line parameter ``--cache-dir`` can each be used to override the
default cache location. The parameter ``--no-cache`` disables the cache
entirely. In this case, all data is loaded from the repo.
The cache is ephemeral: When a file cannot be read from the cache, it is loaded The cache is ephemeral: When a file cannot be read from the cache, it is loaded
from the repository. from the repository.