pgg: Back end methods
4.2 Back end methods
====================
In each back end, these methods must be present. The output of these
methods is stored in special buffers (Getting output), so that
these methods must tell the status of the execution.
-- Method: pgg-scheme-lookup-key scheme string &optional type
Return keys associated with STRING. If the optional third argument
TYPE is non-‘nil’, it searches from the secret keyrings.
-- Method: pgg-scheme-encrypt-region scheme start end recipients
&optional sign passphrase
Encrypt the current region between START and END for RECIPIENTS.
If SIGN is non-‘nil’, do a combined sign and encrypt. If
encryption is successful, it returns ‘t’, otherwise ‘nil’.
-- Method: pgg-scheme-encrypt-symmetric-region scheme start end
&optional passphrase
Encrypt the current region between START and END using a symmetric
cipher and a passphrases. If encryption is successful, it returns
‘t’, otherwise ‘nil’. This function is currently only implemented
for GnuPG.
-- Method: pgg-scheme-decrypt-region scheme start end &optional
passphrase
Decrypt the current region between START and END. If decryption is
successful, it returns ‘t’, otherwise ‘nil’.
-- Method: pgg-scheme-sign-region scheme start end &optional cleartext
passphrase
Make the signature from text between START and END. If the
optional third argument CLEARTEXT is non-‘nil’, it does not create
a detached signature. If signing is successful, it returns ‘t’,
otherwise ‘nil’.
-- Method: pgg-scheme-verify-region scheme start end &optional
signature
Verify the current region between START and END. If the optional
third argument SIGNATURE is non-‘nil’, it is treated as the
detached signature of the current region. If the signature is
successfully verified, it returns ‘t’, otherwise ‘nil’.
-- Method: pgg-scheme-insert-key scheme
Retrieve the user’s public key and insert it as ASCII-armored
format. On success, it returns ‘t’, otherwise ‘nil’.
-- Method: pgg-scheme-snarf-keys-region scheme start end
Collect public keys in the current region between START and END,
and add them into the user’s keyring. On success, it returns ‘t’,
otherwise ‘nil’.