diff options
| author | Marcus Brinkmann <[email protected]> | 2002-03-03 16:46:33 +0000 |
|---|---|---|
| committer | Marcus Brinkmann <[email protected]> | 2002-03-03 16:46:33 +0000 |
| commit | 7d0eebf41a7374a3dc66c9fc138e5470bea0af42 (patch) | |
| tree | 08039e8eeb6f2928f83de6e70ec0c91ca2f43f2c /doc | |
| parent | 2002-03-03 Marcus Brinkmann <[email protected]> (diff) | |
| download | gpgme-7d0eebf41a7374a3dc66c9fc138e5470bea0af42.tar.gz gpgme-7d0eebf41a7374a3dc66c9fc138e5470bea0af42.zip | |
doc/
2002-03-03 Marcus Brinkmann <[email protected]>
* gpgme.texi (Verify): Document verification of normal and
cleartext signatures.
gpgme/
2002-03-03 Marcus Brinkmann <[email protected]>
* 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 <[email protected]>
* gpg/t-verify.c (main): Add a few more sanity checks, and a check
for normal signatures.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gpgme.texi | 17 |
2 files changed, 16 insertions, 6 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 56be6280..88d4fbf9 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2002-03-03 Marcus Brinkmann <[email protected]> + + * gpgme.texi (Verify): Document verification of normal and + cleartext signatures. + 2002-02-27 Marcus Brinkmann <[email protected]> * gpgme.texi (Listing Keys): Document gpgme_op_keylist_ext_start. 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}}) |