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