From e1ec60c2ee4eb66bcd69f4f745ebc1fa1b98ee38 Mon Sep 17 00:00:00 2001 From: Michael Eischer Date: Fri, 31 May 2024 16:11:18 +0200 Subject: [PATCH] document restore --overwrite --- doc/050_restore.rst | 9 +++++++++ doc/075_scripting.rst | 9 ++++++++- 2 files changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/050_restore.rst b/doc/050_restore.rst index ce17a1cf7..b5eb41349 100644 --- a/doc/050_restore.rst +++ b/doc/050_restore.rst @@ -85,6 +85,15 @@ 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 in-place +------------------ + +By default, the ``restore`` command overwrites already existing files in the target +directory. This behavior can be configured via the ``--overwrite`` option. The +default is ``--overwrite always``. To only overwrite existing files if the file in +the snapshot is newer, use ``--overwrite if-newer``. To never overwrite existing files, +use ``--overwrite never``. + Restore using mount =================== diff --git a/doc/075_scripting.rst b/doc/075_scripting.rst index e413e349f..d40f7c976 100644 --- a/doc/075_scripting.rst +++ b/doc/075_scripting.rst @@ -502,11 +502,14 @@ Status +----------------------+------------------------------------------------------------+ |``files_restored`` | Files restored | +----------------------+------------------------------------------------------------+ +|``files_skipped`` | Files skipped due to overwrite setting | ++----------------------+------------------------------------------------------------+ |``total_bytes`` | Total number of bytes in restore set | +----------------------+------------------------------------------------------------+ |``bytes_restored`` | Number of bytes restored | +----------------------+------------------------------------------------------------+ - +|``bytes_skipped`` | Total size of skipped files | ++----------------------+------------------------------------------------------------+ Summary ^^^^^^^ @@ -520,10 +523,14 @@ Summary +----------------------+------------------------------------------------------------+ |``files_restored`` | Files restored | +----------------------+------------------------------------------------------------+ +|``files_skipped`` | Files skipped due to overwrite setting | ++----------------------+------------------------------------------------------------+ |``total_bytes`` | Total number of bytes in restore set | +----------------------+------------------------------------------------------------+ |``bytes_restored`` | Number of bytes restored | +----------------------+------------------------------------------------------------+ +|``bytes_skipped`` | Total size of skipped files | ++----------------------+------------------------------------------------------------+ snapshots