From 3a828bea0b0211e0dc4afd5f33a1f0e286806127 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Thu, 24 Dec 2020 02:36:09 +0100 Subject: [PATCH 1/2] docs: fix description of borg upgrade hardlink usage, fixes #5518 --- docs/usage/general/file-systems.rst.inc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/usage/general/file-systems.rst.inc b/docs/usage/general/file-systems.rst.inc index 137697ca9..32b85deba 100644 --- a/docs/usage/general/file-systems.rst.inc +++ b/docs/usage/general/file-systems.rst.inc @@ -26,4 +26,4 @@ and readable after one of the failures mentioned above occurred, run it should be a move (not a copy) operation, and in case of a directory it should fail if the destination exists and is not an empty directory, since this is used for locking. -- Hardlinks are needed for :ref:`borg_upgrade` ``--inplace`` +- Hardlinks are needed for :ref:`borg_upgrade` (if ``--inplace`` option is not used) From f75c561e07aeb19838231106e542f1a64ed0c6f0 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Thu, 24 Dec 2020 02:41:26 +0100 Subject: [PATCH 2/2] docs: add another case of attempted hardlink usage --- docs/usage/general/file-systems.rst.inc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/usage/general/file-systems.rst.inc b/docs/usage/general/file-systems.rst.inc index 32b85deba..60b7f46f9 100644 --- a/docs/usage/general/file-systems.rst.inc +++ b/docs/usage/general/file-systems.rst.inc @@ -26,4 +26,6 @@ and readable after one of the failures mentioned above occurred, run it should be a move (not a copy) operation, and in case of a directory it should fail if the destination exists and is not an empty directory, since this is used for locking. -- Hardlinks are needed for :ref:`borg_upgrade` (if ``--inplace`` option is not used) +- Hardlinks are needed for :ref:`borg_upgrade` (if ``--inplace`` option is not used). + Also hardlinks are used for more safe and secure file updating (e.g. of the repo + config file), but the code tries to work also if hardlinks are not supported.