mirror of https://github.com/borgbackup/borg.git
Merge pull request #2588 from enkore/docs/quota
docs: quotas: clarify compatbility; only relevant to serve side
This commit is contained in:
commit
d3373bebf1
|
@ -215,6 +215,10 @@ Tracking effective size on the other hand accounts DELETEs immediately as freein
|
||||||
|
|
||||||
The storage quota is meant as a robust mechanism for service providers, therefore
|
The storage quota is meant as a robust mechanism for service providers, therefore
|
||||||
:ref:`borg_serve` has to enforce it without loopholes (e.g. modified clients).
|
:ref:`borg_serve` has to enforce it without loopholes (e.g. modified clients).
|
||||||
|
The following sections refer to using quotas on remotely accessed repositories.
|
||||||
|
For local access, consider *client* and *serve* the same.
|
||||||
|
Accordingly, quotas cannot be enforced with local access,
|
||||||
|
since the quota can be changed in the repository config.
|
||||||
|
|
||||||
The quota is enforcible only if *all* :ref:`borg_serve` versions
|
The quota is enforcible only if *all* :ref:`borg_serve` versions
|
||||||
accessible to clients support quotas (see next section). Further, quota is
|
accessible to clients support quotas (see next section). Further, quota is
|
||||||
|
@ -233,8 +237,11 @@ state).
|
||||||
.. rubric:: Compatibility with older servers and enabling quota after-the-fact
|
.. rubric:: Compatibility with older servers and enabling quota after-the-fact
|
||||||
|
|
||||||
If no quota data is stored in the hints file, Borg assumes zero quota is used.
|
If no quota data is stored in the hints file, Borg assumes zero quota is used.
|
||||||
Thus, if a repository with an enabled quota is written to with an older version
|
Thus, if a repository with an enabled quota is written to with an older ``borg serve``
|
||||||
that does not understand quotas, then the quota usage will be erased.
|
version that does not understand quotas, then the quota usage will be erased.
|
||||||
|
|
||||||
|
The client version is irrelevant to the storage quota and has no part in it.
|
||||||
|
The form of error messages due to exceeding quota varies with client versions.
|
||||||
|
|
||||||
A similar situation arises when upgrading from a Borg release that did not have quotas.
|
A similar situation arises when upgrading from a Borg release that did not have quotas.
|
||||||
Borg will start tracking quota use from the time of the upgrade, starting at zero.
|
Borg will start tracking quota use from the time of the upgrade, starting at zero.
|
||||||
|
|
Loading…
Reference in New Issue