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
12       val);
13

DESCRIPTION

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

DEFAULT

21       None
22

PROTOCOLS

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

EXAMPLE

27       CURL *curl = curl_easy_init();
28       if(curl) {
29         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
30         curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic");
31         curl_easy_setopt(curl, CURLOPT_SSLENGINE_DEFAULT, 1L);
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 set as default.
41
42       CURLE_SSL_ENGINE_SETFAILED - Engine could not be set as default.
43
44       CURLE_NOT_BUILT_IN  - Option not built in, OpenSSL is not the SSL back‐
45       end.
46
47       CURLE_UNKNOWN_OPTION - Option not recognized.
48
49       CURLE_OUT_OF_MEMORY - Insufficient heap space.
50