gtpc1m5gTransmission Control Protocol/Internet Protocol

SSL_CTX_load_and_set_client_CA_list

The SSL_CTX_load_and_set_client_CA_list function loads certificates from a specific file and places the issuer name of each certificate in a specific context (CTX) structure. Each certificate is for a certificate authority (CA) that the server application trusts and is willing to accept as the CA that issued the certificate of the remote client.

Format

#include <openssl/ssl.h>
int SSL_CTX_load_and_set_client_CA_list(SSL_CTX *ctx, const char *file)

ctx
A pointer to a token returned on the SSL_CTX_new call or the SSL_CTX_new_shared call.

file
A pointer to the file that contains the certificates. The file must be in PEM (base64 encoded) format. The maximum length is 255 characters.

Normal Return

Return code 1 indicates that the function was successful.

Error Return

If unsuccessful, the SSL_CTX_load_and_set_client_CA_list function returns NULL. The following are the most likely causes of errors:

Programming Considerations

Examples

For sample SSL applications, go to http://www.ibm.com/tpf/pubs/tpfpubs.htm, click SSL for the TPF 4.1 System: An Online User's Guide, and click Examples from the left navigation bar.

Related Information