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’.