From de5d130ddab8d8635d7b65c48ef2cc06754efc83 Mon Sep 17 00:00:00 2001 From: William Bonnaventure Date: Sat, 13 Jul 2024 21:10:02 +0200 Subject: [PATCH] Update docs for BORG_USE_CHUNKS_ARCHIVE --- docs/faq.rst | 14 ++------------ docs/usage/general/environment.rst.inc | 3 +++ 2 files changed, 5 insertions(+), 12 deletions(-) diff --git a/docs/faq.rst b/docs/faq.rst index 531256fa9..0daa226ca 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -720,18 +720,8 @@ will make the subsequent rebuilds faster (because it needs to transfer less data from the repository). While being faster, the cache needs quite some disk space, which might be unwanted. -There is a temporary (but maybe long lived) hack to avoid using lots of disk -space for chunks.archive.d (see :issue:`235` for details): - -:: - - # this assumes you are working with the same user as the backup. - cd ~/.cache/borg/$(borg config id) - rm -rf chunks.archive.d ; touch chunks.archive.d - -This deletes all the cached archive chunk indexes and replaces the directory -that kept them with a file, so borg won't be able to store anything "in" there -in future. +You can disable the cached archive chunk indexes by setting the environment +variable ``BORG_USE_CHUNKS_ARCHIVE`` to ``no``. This has some pros and cons, though: diff --git a/docs/usage/general/environment.rst.inc b/docs/usage/general/environment.rst.inc index fe06afde6..6cabf3032 100644 --- a/docs/usage/general/environment.rst.inc +++ b/docs/usage/general/environment.rst.inc @@ -67,6 +67,9 @@ General: When set to a numeric value, this determines the maximum "time to live" for the files cache entries (default: 20). The files cache is used to determine quickly whether a file is unchanged. The FAQ explains this more detailed in: :ref:`always_chunking` + BORG_USE_CHUNKS_ARCHIVE + When set to no (default: yes), the ``chunks.archive.d`` folder will not be used. This reduces + disk space usage but slows down cache resyncs. BORG_SHOW_SYSINFO When set to no (default: yes), system information (like OS, Python version, ...) in exceptions is not shown.