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