From: Andre Heinecke
Date: Fri, 6 Jan 2017 11:26:01 +0000 (+0100)
Subject: doc: Document summary values of TOFU_STATS
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?p=gnupg2.git;a=commitdiff_plain;h=refs%2Fheads%2Fdgit%2Fsid
doc: Document summary values of TOFU_STATS
--
Signed-off-by: Andre Heinecke
(cherry picked from commit e1f68337b979fe4b7c3bd095a83ea832e14efb74)
Gbp-Pq: Name 0025-doc-Document-summary-values-of-TOFU_STATS.patch
---
diff --git a/doc/DETAILS b/doc/DETAILS
index 568500e..ac599fc 100644
--- a/doc/DETAILS
+++ b/doc/DETAILS
@@ -761,6 +761,19 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB:
takes on value 0. Instead, if there is a conflict, VALIDITY still
reflects the key's validity (values: 1-4).
+ SUMMARY values use the euclidean distance (m = sqrt(aÂ² + bÂ²)) rather
+ then the sum of the magnitudes (m = a + b) to ensure a balance between
+ verified signatures and encrypted messages.
+
+ Values are calculated based on the number of days where a key was used
+ for verifying a signature or to encrypt to it.
+ The ranges for the values are:
+
+ - 1 :: signature_days + encryption_days == 0
+ - 2 :: 1 <= sqrt(signature_daysÂ² + encryption_daysÂ²) < 8
+ - 3 :: 8 <= sqrt(signature_daysÂ² + encryption_daysÂ²) < 42
+ - 4 :: sqrt(signature_daysÂ² + encryption_daysÂ²) >= 42
+
SIGN-COUNT and ENCRYPTION-COUNT are the number of messages that we
have seen that have been signed by this key / encryption to this
key.