linux default restore only user xattrs, doc update

* On Linux restore only user.* xattrs by default
* restore all for other OSs
* Update docs and changelog about the new restore
flags --exclude-xattr and --include-xattr

Signed-off-by: Tesshu Flower <tflower@redhat.com>
This commit is contained in:
Tesshu Flower
2024-12-02 23:33:15 -05:00
parent 24422e20a6
commit 3ac697d03d
3 changed files with 48 additions and 1 deletions

View File

@@ -88,6 +88,22 @@ disk space. Note that the exact location of the holes can differ from those in
the original file, as their location is determined while restoring and is not
stored explicitly.
Restoring extended file attributes
----------------------------------
By default, user namespaced extended attributes for files are restored on Linux,
and all extended attributes are restored for other operating systems.
Use ``--exclude-xattr`` and ``--include-xattr`` to control which extended
attributes are restored for files in the snapshot. For example, to restore
user and security namespaced extended attributes for files:
.. code-block:: console
$ restic -r /srv/restic-repo restore 79766175 --target /tmp/restore-work --include-xattr user.* --include-xattr security.*
enter password for repository:
restoring <Snapshot of [/home/user/work] at 2015-05-08 21:40:19.884408621 +0200 CEST> to /tmp/restore-work
Restoring in-place
------------------