Merge pull request #4814 from MichaelEischer/fix-tmp-docs

doc: fix tmpdir documentation for windows
This commit is contained in:
Michael Eischer 2024-05-24 18:17:59 +02:00 committed by GitHub
commit b9cbf623fa
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 10 additions and 5 deletions

View File

@ -654,7 +654,8 @@ environment variables. The following lists these environment variables:
RESTIC_PACK_SIZE Target size for pack files
RESTIC_READ_CONCURRENCY Concurrency for file reads
TMPDIR Location for temporary files
TMPDIR Location for temporary files (except Windows)
TMP Location for temporary files (only Windows)
AWS_ACCESS_KEY_ID Amazon S3 access key ID
AWS_SECRET_ACCESS_KEY Amazon S3 secret access key

View File

@ -99,7 +99,8 @@ to a 16 MiB pack size.
The side effect of increasing the pack size is requiring more disk space for temporary pack
files created before uploading. The space must be available in the system default temp
directory, unless overwritten by setting the ``$TMPDIR`` environment variable. In addition,
directory, unless overwritten by setting the ``$TMPDIR`` (except Windows) environment
variable (on Windows use ``$TMP`` or ``$TEMP``). In addition,
depending on the backend the memory usage can also increase by a similar amount. Restic
requires temporary space according to the pack size, multiplied by the number
of backend connections plus one. For example, if the backend uses 5 connections (the default

View File

@ -408,9 +408,12 @@ Temporary files
During some operations (e.g. ``backup`` and ``prune``) restic uses
temporary files to store data. These files will, by default, be saved to
the system's temporary directory, on Linux this is usually located in
``/tmp/``. The environment variable ``TMPDIR`` can be used to specify a
different directory, e.g. to use the directory ``/var/tmp/restic-tmp``
instead of the default, set the environment variable like this:
``/tmp/``. To specify a different directory for temporary files, set
the appropriate environment variable. On non-Windows operating systems,
use the ``TMPDIR`` environment variable. On Windows, use either the
``TMP`` or ``TEMP`` environment variable. For example, to use the
directory ``/var/tmp/restic-tmp`` instead of the default, set the
environment variable as follows:
.. code-block:: console