1--- 2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3SPDX-License-Identifier: curl 4Title: CURLOPT_SSLENGINE_DEFAULT 5Section: 3 6Source: libcurl 7See-also: 8 - CURLOPT_SSLCERT (3) 9 - CURLOPT_SSLENGINE (3) 10Protocol: 11 - TLS 12TLS-backend: 13 - OpenSSL 14Added-in: 7.9.3 15--- 16 17# NAME 18 19CURLOPT_SSLENGINE_DEFAULT - make SSL engine default 20 21# SYNOPSIS 22 23~~~c 24#include <curl/curl.h> 25 26CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE_DEFAULT, long val); 27~~~ 28 29# DESCRIPTION 30 31Pass a long set to 1 to make the already specified crypto engine the default 32for (asymmetric) crypto operations. 33 34This option has no effect unless set after CURLOPT_SSLENGINE(3). 35 36# DEFAULT 37 38None 39 40# %PROTOCOLS% 41 42# EXAMPLE 43 44~~~c 45int 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 63CURLE_OK - Engine set as default. 64 65CURLE_SSL_ENGINE_SETFAILED - Engine could not be set as default. 66 67CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend. 68 69CURLE_UNKNOWN_OPTION - Option not recognized. 70 71CURLE_OUT_OF_MEMORY - Insufficient heap space. 72