CURLINFO_SSL_ENGINES(3)

1CURLINFO_SSL_ENGINES(3)    curl_easy_getinfo options   CURLINFO_SSL_ENGINES(3)
2
3
4

NAME

6       CURLINFO_SSL_ENGINES - get an slist of OpenSSL crypto-engines
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_SSL_ENGINES,
12                                  struct curl_slist **engine_list);
13

DESCRIPTION

15       Pass the address of a 'struct curl_slist *' to receive a linked-list of
16       OpenSSL crypto-engines supported. Note that engines are normally imple‐
17       mented  in  separate  dynamic libraries. Hence not all the returned en‐
18       gines  may   be   available   at   runtime.   NOTE:   you   must   call
19       curl_slist_free_all(3)  on  the list pointer once you are done with it,
20       as libcurl will not free the data for you.
21

PROTOCOLS

23       All TLS based ones.
24

EXAMPLE

26       CURL *curl = curl_easy_init();
27       if(curl) {
28         CURLcode res;
29         struct curl_slist *engines;
30         res = curl_easy_getinfo(curl, CURLINFO_SSL_ENGINES, &engines);
31         if((res == CURLE_OK) && engines) {
32           /* we have a list, free it when done using it */
33           curl_slist_free_all(engines);
34         }
35
36         curl_easy_cleanup(curl);
37       }
38

AVAILABILITY

40       Added in 7.12.3. Available in OpenSSL builds with "engine" support.
41

RETURN VALUE

43       Returns CURLE_OK if the option is supported,  and  CURLE_UNKNOWN_OPTION
44       if not.
45