]>
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 | ||
df75c2bf | 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 RS |
55 | |
56 | Licensed under the OpenSSL license (the "License"). You may not use | |
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 |