diff options
| author | Tomas Mraz <tomas@openssl.org> | 2021-03-16 18:29:19 +0100 |
|---|---|---|
| committer | Tomas Mraz <tomas@openssl.org> | 2021-03-19 11:21:30 +0100 |
| commit | 0e2f87c03e1a288f5f58627b373a25f83c59318a (patch) | |
| tree | 8c1c4db97231355a04f7aa75ea54e7f6680a0953 /doc/man3 | |
| parent | test: fix Coverity 1454818: use after free (diff) | |
| download | openssl-0e2f87c03e1a288f5f58627b373a25f83c59318a.tar.xz openssl-0e2f87c03e1a288f5f58627b373a25f83c59318a.zip | |
Added functions for printing EVP_PKEYs to FILE *
Fixes #14172
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/14577)
Diffstat (limited to 'doc/man3')
| -rw-r--r-- | doc/man3/EVP_PKEY_print_private.pod | 30 |
1 files changed, 23 insertions, 7 deletions
diff --git a/doc/man3/EVP_PKEY_print_private.pod b/doc/man3/EVP_PKEY_print_private.pod index 0e8f889fce..2fe765630e 100644 --- a/doc/man3/EVP_PKEY_print_private.pod +++ b/doc/man3/EVP_PKEY_print_private.pod @@ -2,7 +2,9 @@ =head1 NAME -EVP_PKEY_print_public, EVP_PKEY_print_private, EVP_PKEY_print_params - public key algorithm printing routines +EVP_PKEY_print_public, EVP_PKEY_print_private, EVP_PKEY_print_params, +EVP_PKEY_print_public_fp, EVP_PKEY_print_private_fp, +EVP_PKEY_print_params_fp - public key algorithm printing routines =head1 SYNOPSIS @@ -10,25 +12,35 @@ EVP_PKEY_print_public, EVP_PKEY_print_private, EVP_PKEY_print_params - public ke int EVP_PKEY_print_public(BIO *out, const EVP_PKEY *pkey, int indent, ASN1_PCTX *pctx); + int EVP_PKEY_print_public_fp(FILE *fp, const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx); int EVP_PKEY_print_private(BIO *out, const EVP_PKEY *pkey, int indent, ASN1_PCTX *pctx); + int EVP_PKEY_print_private_fp(FILE *fp, const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx); int EVP_PKEY_print_params(BIO *out, const EVP_PKEY *pkey, int indent, ASN1_PCTX *pctx); + int EVP_PKEY_print_params_fp(FILE *fp, const EVP_PKEY *pkey, + int indent, ASN1_PCTX *pctx); =head1 DESCRIPTION The functions EVP_PKEY_print_public(), EVP_PKEY_print_private() and EVP_PKEY_print_params() print out the public, private or parameter components -of key B<pkey> respectively. The key is sent to BIO B<out> in human readable -form. The parameter B<indent> indicated how far the printout should be indented. +of key I<pkey> respectively. The key is sent to B<BIO> I<out> in human readable +form. The parameter I<indent> indicates how far the printout should be indented. -The B<pctx> parameter allows the print output to be finely tuned by using -ASN1 printing options. If B<pctx> is set to NULL then default values will +The I<pctx> parameter allows the print output to be finely tuned by using +ASN1 printing options. If I<pctx> is set to NULL then default values will be used. +The functions EVP_PKEY_print_public_fp(), EVP_PKEY_print_private_fp() and +EVP_PKEY_print_params_fp() do the same as the B<BIO> based functions +but use B<FILE> I<fp> instead. + =head1 NOTES -Currently no public key algorithms include any options in the B<pctx> parameter. +Currently no public key algorithms include any options in the I<pctx> parameter. If the key does not include all the components indicated by the function then only those contained in the key will be printed. For example passing a public @@ -47,7 +59,11 @@ L<EVP_PKEY_keygen(3)> =head1 HISTORY -These functions were added in OpenSSL 1.0.0. +The functions EVP_PKEY_print_public(), EVP_PKEY_print_private(), +and EVP_PKEY_print_params() were added in OpenSSL 1.0.0. + +The functions EVP_PKEY_print_public_fp(), EVP_PKEY_print_private_fp(), +and EVP_PKEY_print_params_fp() were added in OpenSSL 3.0. =head1 COPYRIGHT |