CURLOPT_SSLENGINE_DEFAULT(3)

1CURLOPT_SSLENGINE_DEFAULT(3)curl_easy_setopt optionsCURLOPT_SSLENGINE_DEFAULT(3)
2
3
4

NAME

6       CURLOPT_SSLENGINE_DEFAULT - make SSL engine default
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE_DEFAULT, long val);
12

DESCRIPTION

14       Pass  a  long  set to 1 to make the already specified crypto engine the
15       default for (asymmetric) crypto operations.
16
17       This option has no effect unless set after CURLOPT_SSLENGINE(3).
18

DEFAULT

20       None
21

PROTOCOLS

23       All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
24

EXAMPLE

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

AVAILABILITY

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

RETURN VALUE

39       CURLE_OK - Engine set as default.
40
41       CURLE_SSL_ENGINE_SETFAILED - Engine could not be set as default.
42
43       CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL  back‐
44       end.
45
46       CURLE_UNKNOWN_OPTION - Option not recognized.
47
48       CURLE_OUT_OF_MEMORY - Insufficient heap space.
49