1=pod
2
3=head1 NAME
4
5SSL_get_client_CA_list, SSL_CTX_get_client_CA_list - get list of client CAs
6
7=head1 SYNOPSIS
8
9 #include <openssl/ssl.h>
10
11 STACK_OF(X509_NAME) *SSL_get_client_CA_list(const SSL *s);
12 STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(const SSL_CTX *ctx); 
13
14=head1 DESCRIPTION
15
16SSL_CTX_get_client_CA_list() returns the list of client CAs explicitly set for
17B<ctx> using L<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>.
18
19SSL_get_client_CA_list() returns the list of client CAs explicitly
20set for B<ssl> using SSL_set_client_CA_list() or B<ssl>'s SSL_CTX object with
21L<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>, when in
22server mode. In client mode, SSL_get_client_CA_list returns the list of
23client CAs sent from the server, if any.
24
25=head1 RETURN VALUES
26
27SSL_CTX_set_client_CA_list() and SSL_set_client_CA_list() do not return
28diagnostic information.
29
30SSL_CTX_add_client_CA() and SSL_add_client_CA() have the following return
31values:
32
33=over 4
34
35=item STACK_OF(X509_NAMES)
36
37List of CA names explicitly set (for B<ctx> or in server mode) or send
38by the server (client mode).
39
40=item NULL
41
42No client CA list was explicitly set (for B<ctx> or in server mode) or
43the server did not send a list of CAs (client mode).
44
45=back
46
47=head1 SEE ALSO
48
49L<ssl(3)|ssl(3)>,
50L<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>,
51L<SSL_CTX_set_client_cert_cb(3)|SSL_CTX_set_client_cert_cb(3)>
52
53=cut
54