mirror of
https://github.com/curl/curl.git
synced 2026-05-22 23:46:24 +03:00
e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
70 lines
1.3 KiB
Markdown
70 lines
1.3 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_SSLENGINE_DEFAULT
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_SSLCERT (3)
|
|
- CURLOPT_SSLENGINE (3)
|
|
Protocol:
|
|
- TLS
|
|
TLS-backend:
|
|
- OpenSSL
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_SSLENGINE_DEFAULT - make SSL engine default
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLENGINE_DEFAULT, long val);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Pass a long set to 1 to make the already specified crypto engine the default
|
|
for (asymmetric) crypto operations.
|
|
|
|
This option has no effect unless set after CURLOPT_SSLENGINE(3).
|
|
|
|
# DEFAULT
|
|
|
|
None
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
CURLcode res;
|
|
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
|
|
curl_easy_setopt(curl, CURLOPT_SSLENGINE, "dynamic");
|
|
curl_easy_setopt(curl, CURLOPT_SSLENGINE_DEFAULT, 1L);
|
|
res = curl_easy_perform(curl);
|
|
curl_easy_cleanup(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Only if the SSL backend is OpenSSL built with engine support.
|
|
|
|
# RETURN VALUE
|
|
|
|
CURLE_OK - Engine set as default.
|
|
|
|
CURLE_SSL_ENGINE_SETFAILED - Engine could not be set as default.
|
|
|
|
CURLE_NOT_BUILT_IN - Option not built in, OpenSSL is not the SSL backend.
|
|
|
|
CURLE_UNKNOWN_OPTION - Option not recognized.
|
|
|
|
CURLE_OUT_OF_MEMORY - Insufficient heap space.
|