From afabac4c9dbc0ee0a88ad225b27be3836509f5f9 Mon Sep 17 00:00:00 2001 From: Werner Koch Date: Tue, 17 Feb 2004 15:27:42 +0000 Subject: * gpgme.texi (Key Listing Mode): Doc KEYLIST_MODE_VALIDATE. * gpgme.h: Add GPGME_KEYLIST_MODE_VALIDATE. * engine-gpgsm.c (gpgsm_keylist): Send this to gpgsm. --- doc/ChangeLog | 4 ++++ doc/gpgme.texi | 13 ++++++++++++- 2 files changed, 16 insertions(+), 1 deletion(-) (limited to 'doc') diff --git a/doc/ChangeLog b/doc/ChangeLog index 0565d7e4..809cc14d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2004-02-17 Werner Koch + + * gpgme.texi (Key Listing Mode): Doc KEYLIST_MODE_VALIDATE. + 2004-02-06 Moritz Schulte * gpgme.texi: A couple of small fixes regarding the Largfile diff --git a/doc/gpgme.texi b/doc/gpgme.texi index 4f735c8e..3e5e8989 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -1983,6 +1983,14 @@ certificate server. @item GPGME_KEYLIST_MODE_SIGS The @code{GPGME_KEYLIST_MODE_SIGS} symbol specifies that the key signatures should be included in the listed keys. + +@item GPGME_KEYLIST_MODE_VALIDATE +The @code{GPGME_KEYLIST_MODE_VALIDATE} symbol specifies that the +backend should do key or certificate validation and not just get the +validity information from an interna cache. This might be an +expensive operation and is in general not usefule. Currently only +implemented for the S/MIME backend and ignored for other backends. + @end table At least one of @code{GPGME_KEYLIST_MODE_LOCAL} and @@ -2348,7 +2356,10 @@ This is true if the key is expired. This is true if the key is disabled. @item unsigned int invalid : 1 -This is true if the key is invalid. +This is true if the key is invalid. This might have several reasons, +for a example for the S/MIME backend, it will be set in during key +listsing if the key could not be validated due to a missing +certificates or unmatched policies. @item unsigned int can_encrypt : 1 This is true if the key (ie one of its subkeys) can be used for -- cgit v1.2.3