aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorWerner Koch <[email protected]>2016-08-24 17:56:14 +0000
committerWerner Koch <[email protected]>2016-08-24 17:56:14 +0000
commit0f1f02acc1cdcc2cf74a97b05507bb1f062f8af2 (patch)
treecb7236e837ed08022a8ba13ba7d84fb129c3ce2e /doc
parentcommon: Guarantee that gnupg_get_time does not return an error. (diff)
downloadgnupg-0f1f02acc1cdcc2cf74a97b05507bb1f062f8af2.tar.gz
gnupg-0f1f02acc1cdcc2cf74a97b05507bb1f062f8af2.zip
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 <[email protected]>
Diffstat (limited to 'doc')
-rw-r--r--doc/DETAILS21
1 files changed, 18 insertions, 3 deletions
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 <long_string>