SSL_get_client_CA_list.pod revision 72613
1169695Skan=pod
2169695Skan
3169695Skan=head1 NAME
4169695Skan
5169695SkanSSL_get_client_CA_list, SSL_CTX_get_client_CA_list - get list of client CAs
6169695Skan
7169695Skan=head1 SYNOPSIS
8169695Skan
9169695Skan #include <openssl/ssl.h>
10169695Skan
11169695Skan STACK_OF(X509_NAME) *SSL_get_client_CA_list(SSL *s);
12169695Skan STACK_OF(X509_NAME) *SSL_CTX_get_client_CA_list(SSL_CTX *ctx); 
13169695Skan
14169695Skan=head1 DESCRIPTION
15169695Skan
16169695SkanSSL_CTX_get_client_CA_list() returns the list of client CAs explicitely set for
17169695SkanB<ctx> using L<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>.
18169695Skan
19169695SkanSSL_get_client_CA_list() returns the list of client CAs explicitely
20169695Skanset for B<ssl> using SSL_set_client_CA_list() or B<ssl>'s SSL_CTX object with
21169695SkanL<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>, when in
22169695Skanserver mode. In client mode, SSL_get_client_CA_list returns the list of
23169695Skanclient CAs sent from the server, if any.
24169695Skan
25169695Skan=head1 RETURN VALUES
26169695Skan
27169695SkanSSL_CTX_set_client_CA_list() and SSL_set_client_CA_list() do not return
28169695Skandiagnostic information.
29169695Skan
30169695SkanSSL_CTX_add_client_CA() and SSL_add_client_CA() have the following return
31169695Skanvalues:
32169695Skan
33169695Skan=over 4
34169695Skan
35169695Skan=item STACK_OF(X509_NAMES)
36169695Skan
37169695SkanList of CA names explicitely set (for B<ctx> or in server mode) or send
38169695Skanby the server (client mode).
39169695Skan
40169695Skan=item NULL
41169695Skan
42169695SkanNo client CA list was explicitely set (for B<ctx> or in server mode) or
43169695Skanthe server did not send a list of CAs (client mode).
44169695Skan
45169695Skan=back
46169695Skan
47169695Skan=head1 SEE ALSO
48169695Skan
49169695SkanL<ssl(3)|ssl(3)>,
50169695SkanL<SSL_CTX_set_client_CA_list(3)|SSL_CTX_set_client_CA_list(3)>
51169695Skan
52169695Skan=cut
53169695Skan