projects / thirdparty / openssl.git / blame
| Commit | Line | Data |
|---|---|---|
| 8211a33c DSH |
1 | =pod |
| 2 | ||
| 3 | =head1 NAME | |
| 4 | ||
| bb9ad09e | 5 | EVP_PKEY_print_public, EVP_PKEY_print_private, EVP_PKEY_print_params - public key algorithm printing routines |
| 8211a33c DSH |
6 | |
| 7 | =head1 SYNOPSIS | |
| 8 | ||
| 9 | #include <openssl/evp.h> | |
| 10 | ||
| 11 | int EVP_PKEY_print_public(BIO *out, const EVP_PKEY *pkey, | |
| e9b77246 | 12 | int indent, ASN1_PCTX *pctx); |
| 8211a33c | 13 | int EVP_PKEY_print_private(BIO *out, const EVP_PKEY *pkey, |
| e9b77246 | 14 | int indent, ASN1_PCTX *pctx); |
| 8211a33c | 15 | int EVP_PKEY_print_params(BIO *out, const EVP_PKEY *pkey, |
| e9b77246 | 16 | int indent, ASN1_PCTX *pctx); |
| 8211a33c DSH |
17 | |
| 18 | =head1 DESCRIPTION | |
| 19 | ||
| 20 | The functions EVP_PKEY_print_public(), EVP_PKEY_print_private() and | |
| 21 | EVP_PKEY_print_params() print out the public, private or parameter components | |
| 22 | of key B<pkey> respectively. The key is sent to BIO B<out> in human readable | |
| 23 | form. The parameter B<indent> indicated how far the printout should be indented. | |
| 24 | ||
| 25 | The B<pctx> parameter allows the print output to be finely tuned by using | |
| 26 | ASN1 printing options. If B<pctx> is set to NULL then default values will | |
| 27 | be used. | |
| 28 | ||
| 29 | =head1 NOTES | |
| 30 | ||
| a970b14f | 31 | Currently no public key algorithms include any options in the B<pctx> parameter. |
| 8211a33c DSH |
32 | |
| 33 | If the key does not include all the components indicated by the function then | |
| 34 | only those contained in the key will be printed. For example passing a public | |
| 35 | key to EVP_PKEY_print_private() will only print the public components. | |
| 36 | ||
| 37 | =head1 RETURN VALUES | |
| 38 | ||
| 39 | These functions all return 1 for success and 0 or a negative value for failure. | |
| 40 | In particular a return value of -2 indicates the operation is not supported by | |
| 41 | the public key algorithm. | |
| 42 | ||
| 43 | =head1 SEE ALSO | |
| 44 | ||
| 9b86974e | 45 | L<EVP_PKEY_CTX_new(3)>, |
| 1bc74519 | 46 | L<EVP_PKEY_keygen(3)> |
| 8211a33c DSH |
47 | |
| 48 | =head1 HISTORY | |
| 49 | ||
| fc5ecadd | 50 | These functions were added in OpenSSL 1.0.0. |
| 8211a33c | 51 | |
| e2f92610 RS |
52 | =head1 COPYRIGHT |
| 53 | ||
| a970b14f | 54 | Copyright 2006-2017 The OpenSSL Project Authors. All Rights Reserved. |
| e2f92610 | 55 | |
| 4746f25a | 56 | Licensed under the Apache License 2.0 (the "License"). You may not use |
| e2f92610 RS |
57 | this file except in compliance with the License. You can obtain a copy |
| 58 | in the file LICENSE in the source distribution or at | |
| 59 | L<https://www.openssl.org/source/license.html>. | |
| 60 | ||
| 61 | =cut |