diff options
author | Thomas Waldmann <tw@waldmann-edv.de> | 2016-07-06 01:33:53 +0200 |
---|---|---|
committer | Thomas Waldmann <tw@waldmann-edv.de> | 2016-07-06 01:33:53 +0200 |
commit | 12f55f4e9fb524f2a9ba161803a133d7a8eace3b (patch) | |
tree | 9af6c0729c0ed0697da1fa61efe650e3924bf337 /docs/usage/check.rst.inc | |
parent | f363ddd7caea65ef6552ef398a68ada2dbc8fcfa (diff) | |
parent | 8db670cf7fee04e9c79b8a4291bd488d2195bf48 (diff) |
Merge branch '1.0-maint'
Diffstat (limited to 'docs/usage/check.rst.inc')
-rw-r--r-- | docs/usage/check.rst.inc | 18 |
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/usage/check.rst.inc b/docs/usage/check.rst.inc index 4dd5b05fb..187172ffd 100644 --- a/docs/usage/check.rst.inc +++ b/docs/usage/check.rst.inc @@ -1,3 +1,5 @@ +.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit! + .. _borg_check: borg check @@ -15,6 +17,8 @@ optional arguments | only perform repository checks ``--archives-only`` | only perform archives checks + ``--verify-data`` + | perform cryptographic archive data integrity verification (conflicts with --repository-only) ``--repair`` | attempt to repair any inconsistencies found ``--save-space`` @@ -23,6 +27,8 @@ optional arguments | only check last N archives (Default: all) ``-P``, ``--prefix`` | only consider archive names starting with this prefix + ``-p``, ``--progress`` + | show progress display while checking `Common options`_ | @@ -64,3 +70,15 @@ Second, the consistency and correctness of the archive metadata is verified: required). - The archive checks can be time consuming, they can be skipped using the --repository-only option. + +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, +which will detect (accidental) corruption. For encrypted repositories it is +tamper-resistant as well, unless the attacker has access to the keys. + +It is also very slow. + +--verify-data only verifies data used by the archives specified with --last, +--prefix or an explicitly named archive. If none of these are passed, +all data in the repository is verified. |