From 0f1f02acc1cdcc2cf74a97b05507bb1f062f8af2 Mon Sep 17 00:00:00 2001 From: Werner Koch Date: Wed, 24 Aug 2016 19:56:14 +0200 Subject: gpg: Change TOFU_STATS to return timestamps. * g10/tofu.c (write_stats_status): Add arg FP to print a colon formated line. Adjust for changed TOFU_STATS interface. (show_statistics): Let the query return timestamps and use gnupg_get-time to compute the "time ago" values. Signed-off-by: Werner Koch --- doc/DETAILS | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) (limited to 'doc') diff --git a/doc/DETAILS b/doc/DETAILS index 332e686f2..454f2e315 100644 --- a/doc/DETAILS +++ b/doc/DETAILS @@ -60,6 +60,7 @@ described here. - pkd :: Public key data [*] - grp :: Keygrip - rvk :: Revocation key + - tfs :: TOFU statistics [*] - tru :: Trust database information [*] - spk :: Signature subpacket [*] - cfg :: Configuration data [*] @@ -230,6 +231,20 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB: !--------- index (eg. DSA goes from 0 to 3: p,q,g,y) #+end_example +*** TFS - TOFU statistics + + This field may follows a UID record to convey information about + the TOFU database. The information is similar to a TOFU_STATS + status line. + + - Field 2 :: tfs record version (must be 1) + - Field 3 :: validity - A number with validity code. + - Field 4 :: signcount - The number of signatures seen. + - Field 5 :: encrcount - The number of encryptions done. + - Field 6 :: policy - A string with the policy + - Field 7 :: first-seen - a timestamp or 0 if not known. + - Field 8 :: most-recent-seen - a timestamp or 0 if not known. + *** TRU - Trust database information Example for a "tru" trust base record: #+begin_example @@ -723,9 +738,9 @@ pkd:0:1024:B665B1435F4C2 .... FF26ABB: - ask :: Policy is "ask" - unknown :: Policy is not known. - TM1 gives the number of seconds since the the first messages was - verified. TM2 gives the number of seconds since the most recent - message was verified. + TM1 ist the time the first messages was verified. TM2 is the time + the most recent message was verified. Both may either be seconds + since Epoch or an ISO time string (yyyymmddThhmmss). *** TOFU_STATS_SHORT -- cgit v1.2.3