The branch master has been updated via e557d463331861c740867f069e1cb8029b46c94a (commit) from 317b7c57e4eb09b83fc30c9823eff98667057429 (commit)
- Log ----------------------------------------------------------------- commit e557d463331861c740867f069e1cb8029b46c94a Author: Shane Lontis <shane.lon...@oracle.com> Date: Thu Nov 12 18:35:14 2020 +1000 Add documentation for EVP_PKEY2PKCS8/EVP_PKCS82PKEY Reviewed-by: Tomas Mraz <tm...@fedoraproject.org> (Merged from https://github.com/openssl/openssl/pull/13388) ----------------------------------------------------------------------- Summary of changes: doc/man3/EVP_PKEY2PKCS8.pod | 47 +++++++++++++++++++++++++++++++++++++++++++++ util/missingcrypto.txt | 3 --- 2 files changed, 47 insertions(+), 3 deletions(-) create mode 100644 doc/man3/EVP_PKEY2PKCS8.pod diff --git a/doc/man3/EVP_PKEY2PKCS8.pod b/doc/man3/EVP_PKEY2PKCS8.pod new file mode 100644 index 0000000000..290a3ba359 --- /dev/null +++ b/doc/man3/EVP_PKEY2PKCS8.pod @@ -0,0 +1,47 @@ +=pod + +=head1 NAME + +EVP_PKEY2PKCS8, EVP_PKCS82PKEY_ex, EVP_PKCS82PKEY +- Convert a private key to/from PKCS8 + +=head1 SYNOPSIS + + #include <openssl/x509.h> + + PKCS8_PRIV_KEY_INFO *EVP_PKEY2PKCS8(const EVP_PKEY *pkey); + EVP_PKEY *EVP_PKCS82PKEY(const PKCS8_PRIV_KEY_INFO *p8); + EVP_PKEY *EVP_PKCS82PKEY_ex(const PKCS8_PRIV_KEY_INFO *p8, OSSL_LIB_CTX *libctx, + const char *propq); + +=head1 DESCRIPTION + +EVP_PKEY2PKCS8() converts a private key I<pkey> into a returned PKCS8 object. + +EVP_PKCS82PKEY_ex() converts a PKCS8 object I<p8> into a returned private key. +It uses I<libctx> and I<propq> when fetching algorithms. + +EVP_PKCS82PKEY() is similiar to EVP_PKCS82PKEY_ex() but uses default values of +NULL for the I<libctx> and I<propq>. + +=head1 RETURN VALUES + +EVP_PKEY2PKCS8() returns a PKCS8 object on success. +EVP_PKCS82PKEY() and EVP_PKCS82PKEY_ex() return a private key on success. + +All functions return NULL if the operation fails. + +=head1 SEE ALSO + +L<PKCS8_pkey_add1_attr(3)>, + +=head1 COPYRIGHT + +Copyright 2020 The OpenSSL Project Authors. All Rights Reserved. + +Licensed under the Apache License 2.0 (the "License"). You may not use +this file except in compliance with the License. You can obtain a copy +in the file LICENSE in the source distribution or at +L<https://www.openssl.org/source/license.html>. + +=cut diff --git a/util/missingcrypto.txt b/util/missingcrypto.txt index 71c0d5002b..dabce0db49 100644 --- a/util/missingcrypto.txt +++ b/util/missingcrypto.txt @@ -672,9 +672,6 @@ EVP_PBE_cleanup(3) EVP_PBE_find(3) EVP_PBE_get(3) EVP_PBE_scrypt(3) -EVP_PKCS82PKEY(3) -EVP_PKCS82PKEY_ex(3) -EVP_PKEY2PKCS8(3) EVP_PKEY_CTX_get0_peerkey(3) EVP_PKEY_CTX_get0_pkey(3) EVP_PKEY_CTX_get_data(3)