diff options
Diffstat (limited to 'src/lib/libcrypto/doc/PKCS12_parse.pod')
| -rw-r--r-- | src/lib/libcrypto/doc/PKCS12_parse.pod | 31 |
1 files changed, 19 insertions, 12 deletions
diff --git a/src/lib/libcrypto/doc/PKCS12_parse.pod b/src/lib/libcrypto/doc/PKCS12_parse.pod index 51344f883a..c54cf2ad61 100644 --- a/src/lib/libcrypto/doc/PKCS12_parse.pod +++ b/src/lib/libcrypto/doc/PKCS12_parse.pod | |||
| @@ -20,24 +20,31 @@ certificate to B<*cert> and any additional certificates to B<*ca>. | |||
| 20 | 20 | ||
| 21 | =head1 NOTES | 21 | =head1 NOTES |
| 22 | 22 | ||
| 23 | The parameters B<pkey> and B<cert> cannot be B<NULL>. B<ca> can be <NULL> | 23 | The parameters B<pkey> and B<cert> cannot be B<NULL>. B<ca> can be <NULL> in |
| 24 | in which case additional certificates will be discarded. B<*ca> can also | 24 | which case additional certificates will be discarded. B<*ca> can also be a |
| 25 | be a valid STACK in which case additional certificates are appended to | 25 | valid STACK in which case additional certificates are appended to B<*ca>. If |
| 26 | B<*ca>. If B<*ca> is B<NULL> a new STACK will be allocated. | 26 | B<*ca> is B<NULL> a new STACK will be allocated. |
| 27 | 27 | ||
| 28 | The B<friendlyName> and B<localKeyID> attributes (if present) on each certificate | 28 | The B<friendlyName> and B<localKeyID> attributes (if present) on each |
| 29 | will be stored in the B<alias> and B<keyid> attributes of the B<X509> structure. | 29 | certificate will be stored in the B<alias> and B<keyid> attributes of the |
| 30 | B<X509> structure. | ||
| 31 | |||
| 32 | =head1 RETURN VALUES | ||
| 33 | |||
| 34 | PKCS12_parse() returns 1 for success and zero if an error occurred. | ||
| 35 | |||
| 36 | The error can be obtained from L<ERR_get_error(3)|ERR_get_error(3)> | ||
| 30 | 37 | ||
| 31 | =head1 BUGS | 38 | =head1 BUGS |
| 32 | 39 | ||
| 33 | Only a single private key and corresponding certificate is returned by this function. | 40 | Only a single private key and corresponding certificate is returned by this |
| 34 | More complex PKCS#12 files with multiple private keys will only return the first | 41 | function. More complex PKCS#12 files with multiple private keys will only |
| 35 | match. | 42 | return the first match. |
| 36 | 43 | ||
| 37 | Only B<friendlyName> and B<localKeyID> attributes are currently stored in certificates. | 44 | Only B<friendlyName> and B<localKeyID> attributes are currently stored in |
| 38 | Other attributes are discarded. | 45 | certificates. Other attributes are discarded. |
| 39 | 46 | ||
| 40 | Attributes currently cannot be store in the private key B<EVP_PKEY> structure. | 47 | Attributes currently cannot be stored in the private key B<EVP_PKEY> structure. |
| 41 | 48 | ||
| 42 | =head1 SEE ALSO | 49 | =head1 SEE ALSO |
| 43 | 50 | ||