MirrorSave
/
restic
mirror of https://github.com/restic/restic.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Update docs for security descriptors

This commit is contained in:
Aneesh Nireshwalia 2024-02-24 13:28:18 -07:00
parent 90916f53de
commit c0a1b9ada5
No known key found for this signature in database
GPG Key ID: 6F5A52831C046F44
3 changed files with 12 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
changelog/unreleased/pull-4611
View File

@ -1,7 +1,7 @@
Enhancement: Back up windows created time and file attributes like hidden flag Enhancement: Back up windows created time and file attributes like hidden flag
Restic did not back up windows-specific meta-data like created time and file attributes like hidden flag. Restic did not back up windows-specific meta-data like created time and file attributes like hidden flag.
Restic now backs up file created time and file attributes like hidden, readonly and encrypted flag when backing up files and folders on windows. Restic now backs up file created time and file attributes like hidden, readonly and encrypted flag when backing up files and folders on Windows.
https://github.com/restic/restic/pull/4611 https://github.com/restic/restic/pull/4611

7
doc/040_backup.rst
View File

@ -481,12 +481,17 @@ written, and the next backup needs to write new metadata again. If you really
want to save the access time for files and directories, you can pass the want to save the access time for files and directories, you can pass the
``--with-atime`` option to the ``backup`` command. ``--with-atime`` option to the ``backup`` command.
Backing up full security descriptors on windows is only possible when the user
has ``SeBackupPrivilege``privilege or is running as admin. This is a restriction
of windows not restic.
If either of these conditions are not met, only the owner, group and DACL will
be backed up.
Note that ``restic`` does not back up some metadata associated with files. Of Note that ``restic`` does not back up some metadata associated with files. Of
particular note are: particular note are:
* File creation date on Unix platforms * File creation date on Unix platforms
* Inode flags on Unix platforms * Inode flags on Unix platforms
* File ownership and ACLs on Windows
Reading data from a command Reading data from a command
*************************** ***************************

5
doc/050_restore.rst
View File

@ -72,6 +72,11 @@ Restoring symbolic links on windows is only possible when the user has
``SeCreateSymbolicLinkPrivilege`` privilege or is running as admin. This is a ``SeCreateSymbolicLinkPrivilege`` privilege or is running as admin. This is a
restriction of windows not restic. restriction of windows not restic.
Restoring full security descriptors on windows is only possible when the user has
``SeRestorePrivilege``, ``SeSecurityPrivilege`` and ``SeTakeOwnershipPrivilege``
privilege or is running as admin. This is a restriction of windows not restic.
If either of these conditions are not met, only the DACL will be restored.
By default, restic does not restore files as sparse. Use ``restore --sparse`` to By default, restic does not restore files as sparse. Use ``restore --sparse`` to
enable the creation of sparse files if supported by the filesystem. Then restic enable the creation of sparse files if supported by the filesystem. Then restic
will restore long runs of zero bytes as holes in the corresponding files. will restore long runs of zero bytes as holes in the corresponding files.