NAME    [Toc]    [Back]

       SSL_load_client_CA_file - Load certificate names from file

SYNOPSIS    [Toc]    [Back]

       #include <openssl/ssl.h>

       STACK_OF(X509_NAME) *SSL_load_client_CA_file(
               const char *file );

DESCRIPTION    [Toc]    [Back]

       The SSL_load_client_CA_file() function reads  certificates
       from  file and returns a STACK_OF(X509_NAME) with the subject
 names found.

NOTES    [Toc]    [Back]

       The SSL_load_client_CA_file() function reads a file of PEM
       formatted  certificates and extracts the X509_NAMES of the
       certificates found. While the name suggests  the  specific
       usage  as  support  for  the  SSL_CTX_set_client_CA_list()
       function, it is not limited to CA certificates.

EXAMPLES    [Toc]    [Back]

       Load names of CAs from file and use  it  as  a  client  CA
       list:
        SSL_CTX *ctx;
        STACK_OF(X509_NAME) *cert_names;

        ...
        cert_names                                              =
       SSL_load_client_CA_file("/path/to/CAfile.pem");
        if (cert_names != NULL)
          SSL_CTX_set_client_CA_list(ctx, cert_names);
        else
          error_handling();
        ...

RETURN VALUES    [Toc]    [Back]

       The following  return  values  can  occur:  The  operation
       failed, check out the error stack for the reason.  Pointer
       to the subject names of  the  successfully  read  certificates.

SEE ALSO    [Toc]    [Back]

       Functions: ssl(3), SSL_CTX_set_client_CA_list(3)



                                       SSL_load_client_CA_file(3)