From 748aa18dc6ca9cb25e534fcf2028fb61fde98318 Mon Sep 17 00:00:00 2001 From: Marcus Brinkmann Date: Wed, 6 Mar 2002 01:40:25 +0000 Subject: doc/ 2002-03-06 Marcus Brinkmann * gpgme.texi (Encrypting a Plaintext): Document symmetric encryption. gpgme/ 2002-03-06 Marcus Brinkmann * encrypt.c (_gpgme_encrypt_sym_status_handler): New function. (gpgme_op_encrypt_start): New variable SYMMETRIC, set it if RECP is null, and if it is set, use _gpgme_encrypt_sym_status_handler as status handler and run _gpgme_passphrase_start. * rungpg.c (_gpgme_gpg_op_encrypt): If RECP is zero, do symmetric encryption. * engine-gpgsm.c (_gpgme_gpgsm_op_encrypt): If RECP is zero, return error value. * rungpg.c (_gpgme_gpg_op_verify): Add "--" argument. tests/ 2002-03-06 Marcus Brinkmann * gpg/t-encrypt-sym.c: New file. * gpg/Makefile.am (TESTS): Add t-encrypt-sym. --- doc/ChangeLog | 5 +++++ doc/gpgme.texi | 7 +++++++ 2 files changed, 12 insertions(+) (limited to 'doc') diff --git a/doc/ChangeLog b/doc/ChangeLog index bdd5f292..72b31b8f 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2002-03-06 Marcus Brinkmann + + * gpgme.texi (Encrypting a Plaintext): Document symmetric + encryption. + 2002-03-06 Marcus Brinkmann * gpgme.texi (Error Strings): Add example. diff --git a/doc/gpgme.texi b/doc/gpgme.texi index 0c2d4136..855f0d49 100644 --- a/doc/gpgme.texi +++ b/doc/gpgme.texi @@ -2289,6 +2289,13 @@ encrypted for all valid recipients and returned in @var{cipher}. More information about the invalid recipients is available with @code{gpgme_get_op_info}. @xref{Detailed Results}. +If @var{recp} is @code{NULL}, symmetric rather than public key +encryption is performed. Symmetrically encrypted cipher text can be +deciphered with @code{gpgme_op_decrypt}. Note that in this case the +crypto backend needs to retrieve a passphrase from the user. +Symmetric encryption is currently only supported for the OpenPGP +crypto backend. + The function returns @code{GPGME_No_Error} if the ciphertext could be created successfully, @code{GPGME_Invalid_Value} if @var{ctx}, @var{rset}, @var{plain} or @var{cipher} is not a valid pointer, -- cgit v1.2.3