172613Skris=pod 272613Skris 372613Skris=head1 NAME 472613Skris 572613SkrisSSL_get_client_CA_list, SSL_CTX_get_client_CA_list - get list of client CAs 672613Skris 772613Skris=head1 SYNOPSIS 872613Skris 972613Skris #include <openssl/ssl.h> 1072613Skris 11160814Ssimon STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s); 12160814Ssimon STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *ctx); 1372613Skris 1472613Skris=head1 DESCRIPTION 1572613Skris 1676866SkrisSSL_CTX_get_client_CA_list() returns the list of client CAs explicitly set for 1772613SkrisB<ctx> using L<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>. 1872613Skris 1976866SkrisSSL_get_client_CA_list() returns the list of client CAs explicitly 2072613Skrisset for B<ssl> using SSL_set_client_CA_list() or B<ssl>'s SSL_CTX object with 2172613SkrisL<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>, when in 2272613Skrisserver mode. In client mode, SSL_get_client_CA_list returns the list of 2372613Skrisclient CAs sent from the server, if any. 2472613Skris 2572613Skris=head1 RETURN VALUES 2672613Skris 2772613SkrisSSL_CTX_set_client_CA_list() and SSL_set_client_CA_list() do not return 2872613Skrisdiagnostic information. 2972613Skris 3072613SkrisSSL_CTX_add_client_CA() and SSL_add_client_CA() have the following return 3172613Skrisvalues: 3272613Skris 3372613Skris=over 4 3472613Skris 3572613Skris=item STACK_OF(X509_NAMES) 3672613Skris 3776866SkrisList of CA names explicitly set (for B<ctx> or in server mode) or send 3872613Skrisby the server (client mode). 3972613Skris 4072613Skris=item NULL 4172613Skris 4276866SkrisNo client CA list was explicitly set (for B<ctx> or in server mode) or 4372613Skristhe server did not send a list of CAs (client mode). 4472613Skris 4572613Skris=back 4672613Skris 4772613Skris=head1 SEE ALSO 4872613Skris 4972613SkrisL<ssl(3)|ssl(3)>, 50100928SnectarL<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>, 51100928SnectarL<SSL_CTX_set_client_cert_cb(3)|SSL_CTX_set_client_cert_cb(3)> 5272613Skris 5372613Skris=cut 54