mirror/restic
1
0
Fork 0
mirror of https://github.com/restic/restic.git synced 2024-12-22 07:43:03 +00:00
Code Issues Releases Wiki Activity

doc: describe how to handle rewrite encoding error

Browse source
This commit is contained in:
Michael Eischer 2024-08-26 14:38:32 +02:00
parent 97eb81564a
commit a45d21e2b9
1 changed files with 7 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

7
doc/045_working_with_repos.rst
View file

@ -305,6 +305,13 @@ In order to preview the changes which ``rewrite`` would make, you can use the
modifying the repository. Instead restic will only print the actions it would modifying the repository. Instead restic will only print the actions it would
perform. perform.
.. note:: The ``rewrite`` command verifies that it does not modify snapshots in
unexpected ways and fails with an ``cannot encode tree at "[...]" without loosing information``
error otherwise. This can occur when rewriting a snapshot created by a newer
version of restic or some third-party implementation.
To convert a snapshot into the format expected by the ``rewrite`` command
use ``restic repair snapshots <snapshotID>``.
Modifying metadata of snapshots Modifying metadata of snapshots
=============================== ===============================