CURLOPT_SSLENGINE_DEFAULT.md (1347B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLOPT_SSLENGINE_DEFAULT 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLOPT_SSLCERT (3) 9 - CURLOPT_SSLENGINE (3) 10 Protocol: 11 - TLS 12 TLS-backend: 13 - OpenSSL 14 Added-in: 7.9.3 15 --- 16 17 # NAME 18 19 CURLOPT_SSLENGINE_DEFAULT - make SSL engine default 20 21 # SYNOPSIS 22 23 ~~~c 24 #include <curl/curl.h> 25 26 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE_DEFAULT, long val); 27 ~~~ 28 29 # DESCRIPTION 30 31 Pass a long set to 1 to make the already specified crypto engine the default 32 for (asymmetric) crypto operations. 33 34 This option has no effect unless set after CURLOPT_SSLENGINE(3). 35 36 # DEFAULT 37 38 None 39 40 # %PROTOCOLS% 41 42 # EXAMPLE 43 44 ~~~c 45 int main(void) 46 { 47 CURL *curl = curl_easy_init(); 48 if(curl) { 49 CURLcode res; 50 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/"); 51 curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic"); 52 curl_easy_setopt(curl, CURLOPT_SSLENGINE_DEFAULT, 1L); 53 res = curl_easy_perform(curl); 54 curl_easy_cleanup(curl); 55 } 56 } 57 ~~~ 58 59 # %AVAILABILITY% 60 61 # RETURN VALUE 62 63 CURLE_OK - Engine set as default. 64 65 CURLE_SSL_ENGINE_SETFAILED - Engine could not be set as default. 66 67 CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend. 68 69 CURLE_UNKNOWN_OPTION - Option not recognized. 70 71 CURLE_OUT_OF_MEMORY - Insufficient heap space.