mirror of
https://github.com/curl/curl.git
synced 2026-05-21 16:26:20 +03:00
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
62 lines
1.2 KiB
Markdown
62 lines
1.2 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_SSL_ENABLE_NPN
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_SSL_ENABLE_ALPN (3)
|
|
- CURLOPT_SSL_OPTIONS (3)
|
|
Protocol:
|
|
- TLS
|
|
TLS-backend:
|
|
- All
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_SSL_ENABLE_NPN - use NPN
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_ENABLE_NPN, long npn);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Deprecated in 7.86.0. Setting this option has no function.
|
|
|
|
Pass a long as parameter, 0 or 1 where 1 is for enable and 0 for disable. This
|
|
option enables/disables NPN in the SSL handshake (if the SSL backend libcurl
|
|
is built to use supports it), which can be used to negotiate http2.
|
|
|
|
# DEFAULT
|
|
|
|
1, enabled
|
|
|
|
# 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_SSL_ENABLE_NPN, 1L);
|
|
res = curl_easy_perform(curl);
|
|
curl_easy_cleanup(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Added in 7.36.0. Deprecated in 7.86.0.
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not.
|