openssl/doc
Richard Levitte 866234ac35 SERIALIZER: add support for serializing EVP_PKEYs
The following public functions is added:

- OSSL_SERIALIZER_CTX_new_by_EVP_PKEY()
- OSSL_SERIALIZER_CTX_set_cipher()
- OSSL_SERIALIZER_CTX_set_passphrase()
- OSSL_SERIALIZER_CTX_set_passphrase_cb()
- OSSL_SERIALIZER_CTX_set_passphrase_ui()

OSSL_SERIALIZER_CTX_new_by_EVP_PKEY() selects a suitable serializer
for the given EVP_PKEY, and sets up the OSSL_SERIALIZER_CTX to
function together with OSSL_SERIALIZER_to_bio() and
OSSL_SERIALIZER_to_fp().

OSSL_SERIALIZER_CTX_set_cipher() indicates what cipher should be used
to produce an encrypted serialization of the EVP_PKEY.  This is passed
directly to the provider using OSSL_SERIALIZER_CTX_set_params().

OSSL_SERIALIZER_CTX_set_passphrase() can be used to set a pass phrase
to be used for the encryption.  This is passed directly to the
provider using OSSL_SERIALIZER_CTX_set_params().

OSSL_SERIALIZER_CTX_set_passphrase_cb() and
OSSL_SERIALIZER_CTX_set_passphrase_ui() sets up a callback to be used
to prompt for a passphrase.  This is stored in the context, and is
called via an internal intermediary at the time of serialization.

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/10394)
2019-11-29 20:55:16 +01:00
..
HOWTO doc/man7/proxy-certificates.pod: New guide for proxy certificates 2019-11-27 16:18:28 +01:00
internal CORE: ossl_namemap_add_names(): new function to add multiple names 2019-11-29 20:42:12 +01:00
man1 Use option/parameter consistently. 2019-11-28 13:58:51 +01:00
man3 SERIALIZER: add support for serializing EVP_PKEYs 2019-11-29 20:55:16 +01:00
man5 Remove RANDFILE settings from configuration files 2019-11-24 08:35:14 +01:00
man7 SERIALIZER: add support for serializing EVP_PKEYs 2019-11-29 20:55:16 +01:00
build.info Add doc/build.info to build the documentation 2019-11-29 09:51:17 +01:00
dir-locals.example.el
fingerprints.txt Remove unnecessary trailing whitespace 2019-02-05 16:25:11 +01:00
openssl-c-indent.el
perlvars.pm Add -CAstore and similar to all openssl commands that have -CApath 2019-11-03 18:38:23 +01:00
README

README  This file

fingerprints.txt
        PGP fingerprints of authorised release signers

standards.txt
        Moved to the web, https://www.openssl.org/docs/standards.html

HOWTO/
        A few how-to documents; not necessarily up-to-date

man1/
        The openssl command-line tools; start with openssl.pod

man3/
        The SSL library and the crypto library

man5/
        File formats

man7/
        Overviews; start with crypto.pod and ssl.pod, for example
        Algorithm specific EVP_PKEY documentation.

Formatted versions of the manpages (apps,ssl,crypto) can be found at
        https://www.openssl.org/docs/manpages.html