mirror of https://github.com/borgbackup/borg.git
Merge pull request #6165 from hexagonrecursion/excluded-parent
docs: excluded parent dir's metadata can't restore
This commit is contained in:
commit
3edb19ac87
|
@ -2369,6 +2369,12 @@ class Archiver:
|
||||||
a directory, it won't recurse into it and won't discover any potential matches for
|
a directory, it won't recurse into it and won't discover any potential matches for
|
||||||
include rules below that directory.
|
include rules below that directory.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
|
||||||
|
It's possible that a sub-directory/file is matched while parent directories are not.
|
||||||
|
In that case, parent directories are not backed up thus their user, group, permission,
|
||||||
|
etc. can not be restored.
|
||||||
|
|
||||||
Note that the default pattern style for ``--pattern`` and ``--patterns-from`` is
|
Note that the default pattern style for ``--pattern`` and ``--patterns-from`` is
|
||||||
shell style (`sh:`), so those patterns behave similar to rsync include/exclude
|
shell style (`sh:`), so those patterns behave similar to rsync include/exclude
|
||||||
patterns. The pattern style can be set via the `P` prefix.
|
patterns. The pattern style can be set via the `P` prefix.
|
||||||
|
@ -3878,6 +3884,10 @@ class Archiver:
|
||||||
|
|
||||||
Currently, extract always writes into the current working directory ("."),
|
Currently, extract always writes into the current working directory ("."),
|
||||||
so make sure you ``cd`` to the right place before calling ``borg extract``.
|
so make sure you ``cd`` to the right place before calling ``borg extract``.
|
||||||
|
|
||||||
|
When parent directories are not extracted (because of using file/directory selection
|
||||||
|
or any other reason), borg can not restore parent directories' metadata, e.g. owner,
|
||||||
|
group, permission, etc.
|
||||||
""")
|
""")
|
||||||
subparser = subparsers.add_parser('extract', parents=[common_parser], add_help=False,
|
subparser = subparsers.add_parser('extract', parents=[common_parser], add_help=False,
|
||||||
description=self.do_extract.__doc__,
|
description=self.do_extract.__doc__,
|
||||||
|
|
Loading…
Reference in New Issue