Commit 16cd15e6 authored by Dr. Stephen Henson's avatar Dr. Stephen Henson
Browse files

Update from 1.0.0-stable.

parent 98a711b4
Loading
Loading
Loading
Loading
+19 −12
Original line number Diff line number Diff line
@@ -20,24 +20,31 @@ certificate to B<*cert> and any additional certificates to B<*ca>.

=head1 NOTES

The parameters B<pkey> and B<cert> cannot be B<NULL>. B<ca> can be <NULL>
in which case additional certificates will be discarded. B<*ca> can also
be a valid STACK in which case additional certificates are appended to
B<*ca>. If B<*ca> is B<NULL> a new STACK will be allocated.
The parameters B<pkey> and B<cert> cannot be B<NULL>. B<ca> can be <NULL> in
which case additional certificates will be discarded. B<*ca> can also be a
valid STACK in which case additional certificates are appended to B<*ca>. If
B<*ca> is B<NULL> a new STACK will be allocated.

The B<friendlyName> and B<localKeyID> attributes (if present) on each certificate
will be stored in the B<alias> and B<keyid> attributes of the B<X509> structure.
The B<friendlyName> and B<localKeyID> attributes (if present) on each
certificate will be stored in the B<alias> and B<keyid> attributes of the
B<X509> structure.

=head1 RETURN VALUES

PKCS12_parse() returns 1 for success and zero if an error occurred.

The error can be obtained from L<ERR_get_error(3)|ERR_get_error(3)>

=head1 BUGS

Only a single private key and corresponding certificate is returned by this function.
More complex PKCS#12 files with multiple private keys will only return the first
match.
Only a single private key and corresponding certificate is returned by this
function. More complex PKCS#12 files with multiple private keys will only
return the first match.

Only B<friendlyName> and B<localKeyID> attributes are currently stored in certificates.
Other attributes are discarded.
Only B<friendlyName> and B<localKeyID> attributes are currently stored in
certificates. Other attributes are discarded.

Attributes currently cannot be store in the private key B<EVP_PKEY> structure.
Attributes currently cannot be stored in the private key B<EVP_PKEY> structure.

=head1 SEE ALSO