repo-compress.rst.inc 3.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. .. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
  2. .. _borg_repo-compress:
  3. borg repo-compress
  4. ------------------
  5. .. code-block:: none
  6. borg [common options] repo-compress [options]
  7. .. only:: html
  8. .. class:: borg-options-table
  9. +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
  10. | **options** |
  11. +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
  12. | | ``-C COMPRESSION``, ``--compression COMPRESSION`` | select compression algorithm, see the output of the "borg help compression" command for details. |
  13. +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
  14. | | ``-s``, ``--stats`` | print statistics |
  15. +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
  16. | .. class:: borg-common-opt-ref |
  17. | |
  18. | :ref:`common_options` |
  19. +-------------------------------------------------------+---------------------------------------------------+--------------------------------------------------------------------------------------------------+
  20. .. raw:: html
  21. <script type='text/javascript'>
  22. $(document).ready(function () {
  23. $('.borg-options-table colgroup').remove();
  24. })
  25. </script>
  26. .. only:: latex
  27. options
  28. -C COMPRESSION, --compression COMPRESSION select compression algorithm, see the output of the "borg help compression" command for details.
  29. -s, --stats print statistics
  30. :ref:`common_options`
  31. |
  32. Description
  33. ~~~~~~~~~~~
  34. Repository (re-)compression (and/or re-obfuscation).
  35. Reads all chunks in the repository and recompresses them if they are not already
  36. using the compression type/level and obfuscation level given via ``--compression``.
  37. If the outcome of the chunk processing indicates a change in compression
  38. type/level or obfuscation level, the processed chunk is written to the repository.
  39. Please note that the outcome might not always be the desired compression
  40. type/level - if no compression gives a shorter output, that might be chosen.
  41. Please note that this command can not work in low (or zero) free disk space
  42. conditions.
  43. If the ``borg repo-compress`` process receives a SIGINT signal (Ctrl-C), the repo
  44. will be committed and compacted and borg will terminate cleanly afterwards.
  45. Both ``--progress`` and ``--stats`` are recommended when ``borg repo-compress``
  46. is used interactively.
  47. You do **not** need to run ``borg compact`` after ``borg repo-compress``.