chiark / gitweb /
Import gnupg2_2.1.17-3.debian.tar.bz2
[gnupg2.git] / patches / 0025-doc-Document-summary-values-of-TOFU_STATS.patch
1 From: Andre Heinecke <aheinecke@intevation.de>
2 Date: Fri, 6 Jan 2017 12:26:01 +0100
3 Subject: doc: Document summary values of TOFU_STATS
4
5 --
6
7 Signed-off-by: Andre Heinecke <aheinecke@intevation.de>
8 (cherry picked from commit e1f68337b979fe4b7c3bd095a83ea832e14efb74)
9 ---
10  doc/DETAILS | 13 +++++++++++++
11  1 file changed, 13 insertions(+)
12
13 diff --git a/doc/DETAILS b/doc/DETAILS
14 index 568500e51..ac599fc62 100644
15 --- a/doc/DETAILS
16 +++ b/doc/DETAILS
17 @@ -761,6 +761,19 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB:
18      takes on value 0.  Instead, if there is a conflict, VALIDITY still
19      reflects the key's validity (values: 1-4).
20  
21 +    SUMMARY values use the euclidean distance (m = sqrt(a² + b²)) rather
22 +    then the sum of the magnitudes (m = a + b) to ensure a balance between
23 +    verified signatures and encrypted messages.
24 +
25 +    Values are calculated based on the number of days where a key was used
26 +    for verifying a signature or to encrypt to it.
27 +    The ranges for the values are:
28 +
29 +    - 1 :: signature_days + encryption_days == 0
30 +    - 2 :: 1 <= sqrt(signature_days² + encryption_days²) < 8
31 +    - 3 :: 8 <= sqrt(signature_days² + encryption_days²) < 42
32 +    - 4 :: sqrt(signature_days² + encryption_days²) >= 42
33 +
34      SIGN-COUNT and ENCRYPTION-COUNT are the number of messages that we
35      have seen that have been signed by this key / encryption to this
36      key.