From 7d0eebf41a7374a3dc66c9fc138e5470bea0af42 Mon Sep 17 00:00:00 2001 From: Marcus Brinkmann Date: Sun, 3 Mar 2002 16:46:33 +0000 Subject: doc/ 2002-03-03 Marcus Brinkmann * gpgme.texi (Verify): Document verification of normal and cleartext signatures. gpgme/ 2002-03-03 Marcus Brinkmann * rungpg.c (_gpgme_gpg_op_verify): If TEXT is of mode GPGME_DATA_MODE_IN, construct a command line that stores the plaintext in TEXT. * verify.c (gpgme_op_verify_start): Accept TEXT being uninitialized, and in this case interpret SIG as a normal or cleartext signature and TEXT as a return data object. * engine-gpgsm.c (_gpgme_gpgsm_op_verify): Likewise. tests/ 2002-03-03 Marcus Brinkmann * gpg/t-verify.c (main): Add a few more sanity checks, and a check for normal signatures. --- doc/gpgme.texi | 17 +++++++++++------ 1 file changed, 11 insertions(+), 6 deletions(-) (limited to 'doc/gpgme.texi') diff --git a/doc/gpgme.texi b/doc/gpgme.texi index a012abb8..f691e50c 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -1907,9 +1907,14 @@ have a different status. You can get each key's status with @end deftp @deftypefun GpgmeError gpgme_op_verify (@w{GpgmeCtx @var{ctx}}, @w{GpgmeData @var{sig}}, @w{GpgmeData @var{plain}}, @w{GpgmeSigStat *@var{r_stat}}) -The function @code{gpgme_op_verify} verifies that the detached -signature in the data object @var{sig} is a valid signature for the -plaintext in the data object @var{plain}. +The function @code{gpgme_op_verify} verifies that the signature in the +data object @var{sig} is a valid signature. If @var{plain} is +initialized with plaintext data, it is assumed that @var{sig} is a +detached signature, and its validity for the plaintext given in +@var{plain} is verified. If @var{plain} is an uninitialized data +object, it is assumed that @var{sig} is a normal (or cleartext) +signature, and the plaintext is available in @var{plain} after +successful verification. The combined status of all signatures is returned in @var{r_stat}. The results of the individual signature verifications can be retrieved @@ -1918,9 +1923,9 @@ with @code{gpgme_get_sig_status} and @code{gpgme_get_sig_key}. The function returns @code{GPGME_No_Error} if the operation could be completed successfully, @code{GPGME_Invalid_Value} if @var{ctx}, @var{sig}, @var{plain} or @var{r_stat} is not a valid pointer, -@code{GPGME_No_Data} if @var{sig} or @var{plain} does not contain any -data to verify, and passes through any errors that are reported by the -crypto engine support routines. +@code{GPGME_No_Data} if @var{sig} does not contain any data to verify, +and passes through any errors that are reported by the crypto engine +support routines. @end deftypefun @deftypefun GpgmeError gpgme_op_verify_start (@w{GpgmeCtx @var{ctx}}, @w{GpgmeData @var{sig}}, @w{GpgmeData @var{plain}}) -- cgit v1.2.3