From e1f68337b979fe4b7c3bd095a83ea832e14efb74 Mon Sep 17 00:00:00 2001 From: Andre Heinecke Date: Fri, 6 Jan 2017 12:26:01 +0100 Subject: [PATCH] doc: Document summary values of TOFU_STATS -- Signed-off-by: Andre Heinecke --- doc/DETAILS | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/DETAILS b/doc/DETAILS index 568500e51..ac599fc62 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.