CURLOPT_SSLENGINE(3)

1CURLOPT_SSLENGINE(3)                libcurl               CURLOPT_SSLENGINE(3)
2
3
4

NAME

6       CURLOPT_SSLENGINE - SSL engine identifier
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE, char *id);
12

DESCRIPTION

14       Pass  a  pointer  to  a null-terminated string as parameter. It will be
15       used as the identifier for the crypto engine you want to use  for  your
16       private key.
17
18       The  application  does not have to keep the string around after setting
19       this option.
20

DEFAULT

22       NULL
23

PROTOCOLS

25       All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
26

EXAMPLE

28       CURL *curl = curl_easy_init();
29       if(curl) {
30         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
31         curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic");
32         ret = curl_easy_perform(curl);
33         curl_easy_cleanup(curl);
34       }
35

AVAILABILITY

37       Only if the SSL backend is OpenSSL built with engine support.
38

RETURN VALUE

40       CURLE_OK - Engine found.
41
42       CURLE_SSL_ENGINE_NOTFOUND - Engine not found, or OpenSSL was not  built
43       with engine support.
44
45       CURLE_SSL_ENGINE_INITFAILED - Engine found but initialization failed.
46
47       CURLE_NOT_BUILT_IN  - Option not built in, OpenSSL is not the SSL back‐
48       end.
49
50       CURLE_UNKNOWN_OPTION - Option not recognized.
51
52       CURLE_OUT_OF_MEMORY - Insufficient heap space.
53