mirror of
https://github.com/borgbackup/borg.git
synced 2024-12-26 17:57:59 +00:00
80 lines
No EOL
3.5 KiB
PHP
80 lines
No EOL
3.5 KiB
PHP
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
.. _borg_repo-space:
|
|
|
|
borg repo-space
|
|
---------------
|
|
.. code-block:: none
|
|
|
|
borg [common options] repo-space [options]
|
|
|
|
.. only:: html
|
|
|
|
.. class:: borg-options-table
|
|
|
|
+-------------------------------------------------------+---------------------+---------------------------------------------------------------------+
|
|
| **optional arguments** |
|
|
+-------------------------------------------------------+---------------------+---------------------------------------------------------------------+
|
|
| | ``--reserve SPACE`` | Amount of space to reserve (e.g. 100M, 1G). Default: 0. |
|
|
+-------------------------------------------------------+---------------------+---------------------------------------------------------------------+
|
|
| | ``--free`` | Free all reserved space. Don't forget to reserve space later again. |
|
|
+-------------------------------------------------------+---------------------+---------------------------------------------------------------------+
|
|
| .. 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
|
|
--reserve SPACE Amount of space to reserve (e.g. 100M, 1G). Default: 0.
|
|
--free Free all reserved space. Don't forget to reserve space later again.
|
|
|
|
|
|
:ref:`common_options`
|
|
|
|
|
|
|
Description
|
|
~~~~~~~~~~~
|
|
|
|
This command manages reserved space in a repository.
|
|
|
|
Borg can not work in disk-full conditions (can not lock a repo and thus can
|
|
not run prune/delete or compact operations to free disk space).
|
|
|
|
To avoid running into dead-end situations like that, you can put some objects
|
|
into a repository that take up some disk space. If you ever run into a
|
|
disk-full situation, you can free that space and then borg will be able to
|
|
run normally, so you can free more disk space by using prune/delete/compact.
|
|
After that, don't forget to reserve space again, in case you run into that
|
|
situation again at a later time.
|
|
|
|
Examples::
|
|
|
|
# Create a new repository:
|
|
$ borg repo-create ...
|
|
# Reserve approx. 1GB of space for emergencies:
|
|
$ borg repo-space --reserve 1G
|
|
|
|
# Check amount of reserved space in the repository:
|
|
$ borg repo-space
|
|
|
|
# EMERGENCY! Free all reserved space to get things back to normal:
|
|
$ borg repo-space --free
|
|
$ borg prune ...
|
|
$ borg delete ...
|
|
$ borg compact -v # only this actually frees space of deleted archives
|
|
$ borg repo-space --reserve 1G # reserve space again for next time
|
|
|
|
|
|
Reserved space is always rounded up to use full reservation blocks of 64MiB. |