2022-10-02 13:39:10 +00:00
|
|
|
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
|
|
2024-09-08 15:18:53 +00:00
|
|
|
.. _borg_repo-compress:
|
2022-10-02 13:39:10 +00:00
|
|
|
|
2024-09-08 15:18:53 +00:00
|
|
|
borg repo-compress
|
|
|
|
|
------------------
|
2022-10-02 13:39:10 +00:00
|
|
|
.. code-block:: none
|
|
|
|
|
|
2024-09-08 15:18:53 +00:00
|
|
|
borg [common options] repo-compress [options]
|
2022-10-02 13:39:10 +00:00
|
|
|
|
|
|
|
|
.. only:: html
|
|
|
|
|
|
|
|
|
|
.. class:: borg-options-table
|
|
|
|
|
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
2024-07-19 18:40:15 +00:00
|
|
|
| **optional arguments** |
|
2022-10-02 13:39:10 +00:00
|
|
|
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``-C COMPRESSION``, ``--compression COMPRESSION`` | select compression algorithm, see the output of the "borg help compression" command for details. |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
|
|
|
|
| | ``-s``, ``--stats`` | print statistics |
|
|
|
|
|
+-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
|
|
|
|
|
| .. 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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2024-07-19 18:40:15 +00:00
|
|
|
optional arguments
|
2022-10-02 13:39:10 +00:00
|
|
|
-C COMPRESSION, --compression COMPRESSION select compression algorithm, see the output of the "borg help compression" command for details.
|
|
|
|
|
-s, --stats print statistics
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
:ref:`common_options`
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Description
|
|
|
|
|
~~~~~~~~~~~
|
|
|
|
|
|
|
|
|
|
Repository (re-)compression (and/or re-obfuscation).
|
|
|
|
|
|
2024-09-07 20:31:48 +00:00
|
|
|
Reads all chunks in the repository and recompresses them if they are not already
|
|
|
|
|
using the compression type/level and obfuscation level given via ``--compression``.
|
2022-10-02 13:39:10 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
Please note that this command can not work in low (or zero) free disk space
|
|
|
|
|
conditions.
|
|
|
|
|
|
2024-09-08 15:18:53 +00:00
|
|
|
If the ``borg repo-compress`` process receives a SIGINT signal (Ctrl-C), the repo
|
2022-10-02 13:39:10 +00:00
|
|
|
will be committed and compacted and borg will terminate cleanly afterwards.
|
|
|
|
|
|
2024-09-08 15:18:53 +00:00
|
|
|
Both ``--progress`` and ``--stats`` are recommended when ``borg repo-compress``
|
2022-10-02 13:39:10 +00:00
|
|
|
is used interactively.
|
|
|
|
|
|
2024-09-08 15:18:53 +00:00
|
|
|
You do **not** need to run ``borg compact`` after ``borg repo-compress``.
|
