diff options
author | Thomas Waldmann <tw@waldmann-edv.de> | 2022-10-02 15:39:10 +0200 |
---|---|---|
committer | Thomas Waldmann <tw@waldmann-edv.de> | 2022-10-02 15:50:41 +0200 |
commit | 5d8d21df4d9260f42bb0f986a78ced6d871c2dd5 (patch) | |
tree | 5c000246a0ecab50dcb3c84e83542a89191fcc1d /docs | |
parent | c6785c8f1559b56a6563e835dc50497c717bc414 (diff) |
rcompress docs / examples / markup fixes
Diffstat (limited to 'docs')
-rw-r--r-- | docs/usage/rcompress.rst | 12 | ||||
-rw-r--r-- | docs/usage/rcompress.rst.inc | 78 |
2 files changed, 90 insertions, 0 deletions
diff --git a/docs/usage/rcompress.rst b/docs/usage/rcompress.rst new file mode 100644 index 000000000..044f065a3 --- /dev/null +++ b/docs/usage/rcompress.rst @@ -0,0 +1,12 @@ +.. include:: rcompress.rst.inc + +Examples +~~~~~~~~ + +:: + + # recompress repo contents + $ borg rcompress --progress --compression=zstd,3 + + # recompress and obfuscate repo contents + $ borg rcompress --progress --compression=obfuscate,1,zstd,3 diff --git a/docs/usage/rcompress.rst.inc b/docs/usage/rcompress.rst.inc new file mode 100644 index 000000000..702536b81 --- /dev/null +++ b/docs/usage/rcompress.rst.inc @@ -0,0 +1,78 @@ +.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit! + +.. _borg_rcompress: + +borg rcompress +-------------- +.. code-block:: none + + borg [common options] rcompress [options] + +.. only:: html + + .. class:: borg-options-table + + +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | **optional arguments** | + +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | | ``-C COMPRESSION``, ``--compression COMPRESSION`` | select compression algorithm, see the output of the "borg help compression" command for details. | + +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | | ``-s``, ``--stats`` | print statistics | + +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | | ``-c SECONDS``, ``--checkpoint-interval SECONDS`` | write checkpoint every SECONDS seconds (Default: 1800) | + +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+ + | .. class:: borg-common-opt-ref | + | | + | :ref:`common_options` | + +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+ + + .. raw:: html + + <script type='text/javascript'> + $(document).ready(function () { + $('.borg-options-table colgroup').remove(); + }) + </script> + +.. only:: latex + + + + optional arguments + -C COMPRESSION, --compression COMPRESSION select compression algorithm, see the output of the "borg help compression" command for details. + -s, --stats print statistics + -c SECONDS, --checkpoint-interval SECONDS write checkpoint every SECONDS seconds (Default: 1800) + + + :ref:`common_options` + | + +Description +~~~~~~~~~~~ + +Repository (re-)compression (and/or re-obfuscation). + +Reads all chunks in the repository (in on-disk order, this is important for +compaction) and recompresses them if they are not already using the compression +type/level and obfuscation level given via ``--compression``. + +If the outcome of the chunk processing indicates a change in compression +type/level or obfuscation level, the processed chunk is written to the repository. +Please note that the outcome might not always be the desired compression +type/level - if no compression gives a shorter output, that might be chosen. + +Every ``--checkpoint-interval``, progress is committed to the repository and +the repository is compacted (this is to keep temporary repo space usage in bounds). +A lower checkpoint interval means lower temporary repo space usage, but also +slower progress due to higher overhead (and vice versa). + +Please note that this command can not work in low (or zero) free disk space +conditions. + +If the ``borg rcompress``process receives a SIGINT signal (Ctrl-C), the repo +will be committed and compacted and borg will terminate cleanly afterwards. + +Both ``--progress`` and ``--stats`` are recommended when ``borg rcompress`` +is used interactively. + +You do **not** need to run ``borg compact`` after ``borg rcompress``.
\ No newline at end of file |