The data contained in this repository can be downloaded to your computer using one of several clients.
Please see the documentation of your version control software client for more information.
Please select the desired protocol below to get the URL.
This URL has Read-Only access.
main_repo / deps / openssl / openssl / doc / ssl / SSL_CTX_add_extra_chain_cert.pod @ aa3b4b4d
History | View | Annotate | Download (1.57 KB)
| 1 |
=pod |
|---|---|
| 2 |
|
| 3 |
=head1 NAME |
| 4 |
|
| 5 |
SSL_CTX_add_extra_chain_cert - add certificate to chain |
| 6 |
|
| 7 |
=head1 SYNOPSIS |
| 8 |
|
| 9 |
#include <openssl/ssl.h> |
| 10 |
|
| 11 |
long SSL_CTX_add_extra_chain_cert(SSL_CTX ctx, X509 *x509) |
| 12 |
|
| 13 |
=head1 DESCRIPTION |
| 14 |
|
| 15 |
SSL_CTX_add_extra_chain_cert() adds the certificate B<x509> to the certificate |
| 16 |
chain presented together with the certificate. Several certificates |
| 17 |
can be added one after the other. |
| 18 |
|
| 19 |
=head1 NOTES |
| 20 |
|
| 21 |
When constructing the certificate chain, the chain will be formed from |
| 22 |
these certificates explicitly specified. If no chain is specified, |
| 23 |
the library will try to complete the chain from the available CA |
| 24 |
certificates in the trusted CA storage, see |
| 25 |
L<SSL_CTX_load_verify_locations(3)|SSL_CTX_load_verify_locations(3)>. |
| 26 |
|
| 27 |
The B<x509> certificate provided to SSL_CTX_add_extra_chain_cert() will be freed by the library when the B<SSL_CTX> is destroyed. An application B<should not> free the B<x509> object. |
| 28 |
|
| 29 |
=head1 RESTRICTIONS |
| 30 |
|
| 31 |
Only one set of extra chain certificates can be specified per SSL_CTX |
| 32 |
structure. Different chains for different certificates (for example if both |
| 33 |
RSA and DSA certificates are specified by the same server) or different SSL |
| 34 |
structures with the same parent SSL_CTX cannot be specified using this |
| 35 |
function. |
| 36 |
|
| 37 |
=head1 RETURN VALUES |
| 38 |
|
| 39 |
SSL_CTX_add_extra_chain_cert() returns 1 on success. Check out the |
| 40 |
error stack to find out the reason for failure otherwise. |
| 41 |
|
| 42 |
=head1 SEE ALSO |
| 43 |
|
| 44 |
L<ssl(3)|ssl(3)>, |
| 45 |
L<SSL_CTX_use_certificate(3)|SSL_CTX_use_certificate(3)>, |
| 46 |
L<SSL_CTX_set_client_cert_cb(3)|SSL_CTX_set_client_cert_cb(3)>, |
| 47 |
L<SSL_CTX_load_verify_locations(3)|SSL_CTX_load_verify_locations(3)> |
| 48 |
|
| 49 |
=cut |