| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  | =pod | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 NAME | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-06-06 12:43:05 +08:00
										 |  |  | EVP_PKEY_print_public, EVP_PKEY_print_private, EVP_PKEY_print_params - public key algorithm printing routines | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | =head1 SYNOPSIS | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  #include <openssl/evp.h> | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |  int EVP_PKEY_print_public(BIO *out, const EVP_PKEY *pkey, | 
					
						
							| 
									
										
										
										
											2017-01-21 02:58:49 +08:00
										 |  |  |                            int indent, ASN1_PCTX *pctx); | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  |  int EVP_PKEY_print_private(BIO *out, const EVP_PKEY *pkey, | 
					
						
							| 
									
										
										
										
											2017-01-21 02:58:49 +08:00
										 |  |  |                             int indent, ASN1_PCTX *pctx); | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  |  int EVP_PKEY_print_params(BIO *out, const EVP_PKEY *pkey, | 
					
						
							| 
									
										
										
										
											2017-01-21 02:58:49 +08:00
										 |  |  |                            int indent, ASN1_PCTX *pctx); | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | =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. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | 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 | 
					
						
							|  |  |  | be used. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 NOTES | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-08-01 06:58:40 +08:00
										 |  |  | Currently no public key algorithms include any options in the B<pctx> parameter. | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | 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 | 
					
						
							|  |  |  | key to EVP_PKEY_print_private() will only print the public components. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 RETURN VALUES | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | These functions all return 1 for success and 0 or a negative value for failure. | 
					
						
							|  |  |  | In particular a return value of -2 indicates the operation is not supported by | 
					
						
							|  |  |  | the public key algorithm. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | =head1 SEE ALSO | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2015-08-18 03:21:33 +08:00
										 |  |  | L<EVP_PKEY_CTX_new(3)>, | 
					
						
							| 
									
										
										
										
											2016-05-20 20:11:46 +08:00
										 |  |  | L<EVP_PKEY_keygen(3)> | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | =head1 HISTORY | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-10-01 07:43:01 +08:00
										 |  |  | These functions were first added to OpenSSL 1.0.0. | 
					
						
							| 
									
										
										
										
											2006-07-09 19:26:13 +08:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2016-05-18 23:44:05 +08:00
										 |  |  | =head1 COPYRIGHT | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2017-08-01 06:58:40 +08:00
										 |  |  | Copyright 2006-2017 The OpenSSL Project Authors. All Rights Reserved. | 
					
						
							| 
									
										
										
										
											2016-05-18 23:44:05 +08:00
										 |  |  | 
 | 
					
						
							|  |  |  | Licensed under the OpenSSL license (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 |