From 0b65a79a792ab0ebee3467e88a1afd1b4b845e73 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Mon, 22 Apr 2019 17:54:43 +0200 Subject: [PATCH 1/3] update CHANGES (master) --- docs/changes.rst | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/changes.rst b/docs/changes.rst index 9447d3814..10c1dddd9 100644 --- a/docs/changes.rst +++ b/docs/changes.rst @@ -171,8 +171,8 @@ The best check that everything is ok is to run a dry-run extraction:: Changelog ========= -Version 1.2.0a6 (not released yet) ----------------------------------- +Version 1.2.0a6 (2019-04-22) +---------------------------- Please note: @@ -218,6 +218,7 @@ Compatibility notes: Fixes: - delete / prune: consider part files correctly for stats, #4507 +- fix "all archives" stats considering part files, #4329 - create: only run stat_simple_attrs() once - create: --stats does not work with --dry-run, exit with error msg, #4373 - give "invalid repo" error msg if repo config not found, #4411 @@ -237,6 +238,8 @@ Other changes: - travis: use py 3.5.3 and 3.6.7 on macOS to get a pyenv-based python build with openssl 1.1 + - vagrant: use py 3.5.3 and 3.6.8 on darwin64 VM to build python and + borg with openssl 1.1 - pytest: -v and default XDISTN to 1, #4481 From 1f527464ab0a479a3792c771e3085cd75e648f91 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Mon, 22 Apr 2019 18:00:28 +0200 Subject: [PATCH 2/3] build_usage --- docs/usage/check.rst.inc | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/usage/check.rst.inc b/docs/usage/check.rst.inc index aca5d4960..5843fccc9 100644 --- a/docs/usage/check.rst.inc +++ b/docs/usage/check.rst.inc @@ -100,6 +100,7 @@ First, the underlying repository data files are checked: - If you use a remote repo server via ssh:, the repo check is executed on the repo server without causing significant network traffic. - The repository check can be skipped using the ``--archives-only`` option. +- A repository check can be time consuming. Partial checks are possible with the ``--max-duration`` option. Second, the consistency and correctness of the archive metadata is verified: @@ -123,6 +124,16 @@ Second, the consistency and correctness of the archive metadata is verified: - The archive checks can be time consuming, they can be skipped using the ``--repository-only`` option. +The ``--max-duration`` option can be used to split a long-running repository check into multiple partial checks. +After the given number of seconds the check is interrupted. The next partial check will continue where the +previous one stopped, until the complete repository has been checked. Example: Assuming a full check took 7 +hours, then running a daily check with --max-duration=3600 (1 hour) would result in one full check per week. + +Attention: Partial checks can only do way less checks than a full check (only the CRC32 checks on segment file +entries are done) and cannot be combined with ``--repair``. Partial checks may therefore be useful only with very +large repositories where a full check would take too long. Doing a full repository check aborts a partial check; +the next partial check will start from the beginning. + The ``--verify-data`` option will perform a full integrity verification (as opposed to checking the CRC32 of the segment) of data, which means reading the data from the repository, decrypting and decompressing it. This is a cryptographic verification, From 78cb2b1de531587319f0377261f8d4f95ded1c37 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Mon, 22 Apr 2019 18:00:56 +0200 Subject: [PATCH 3/3] build_man --- docs/man/borg-benchmark-crud.1 | 2 +- docs/man/borg-benchmark.1 | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/man/borg-benchmark-crud.1 b/docs/man/borg-benchmark-crud.1 index 650663734..266cd87b0 100644 --- a/docs/man/borg-benchmark-crud.1 +++ b/docs/man/borg-benchmark-crud.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH BORG-BENCHMARK-CRUD 1 "2019-03-21" "" "borg backup tool" +.TH BORG-BENCHMARK-CRUD 1 "2019-04-22" "" "borg backup tool" .SH NAME borg-benchmark-crud \- Benchmark Create, Read, Update, Delete for archives. . diff --git a/docs/man/borg-benchmark.1 b/docs/man/borg-benchmark.1 index 8f000dec4..38aafa30e 100644 --- a/docs/man/borg-benchmark.1 +++ b/docs/man/borg-benchmark.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH BORG-BENCHMARK 1 "2019-03-21" "" "borg backup tool" +.TH BORG-BENCHMARK 1 "2019-04-22" "" "borg backup tool" .SH NAME borg-benchmark \- benchmark command .