1CURLOPT_SSL_FALSESTART(3)  curl_easy_setopt options  CURLOPT_SSL_FALSESTART(3)
2
3
4

NAME

6       CURLOPT_SSL_FALSESTART - enable TLS false start
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_SSL_FALSESTART, long
12       enable);
13

DESCRIPTION

15       Pass a long as parameter set to 1L to enable or 0 to disable.
16
17       This option determines whether libcurl should use  false  start  during
18       the  TLS handshake. False start is a mode where a TLS client will start
19       sending application data before verifying the  server's  Finished  mes‐
20       sage, thus saving a round trip when performing a full handshake.
21

DEFAULT

23       0
24

PROTOCOLS

26       All TLS based protocols: HTTPS, FTPS, IMAPS, POP3S, SMTPS etc.
27

EXAMPLE

29       CURL *curl = curl_easy_init();
30       if(curl) {
31         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
32         curl_easy_setopt(curl, CURLOPT_SSL_FALSESTART, 1L);
33         curl_easy_perform(curl);
34       }
35

AVAILABILITY

37       Added in 7.42.0. This option is currently only supported by the NSS and
38       Secure Transport (on iOS 7.0 or later, or OS X 10.9 or later) TLS back‐
39       ends.
40

RETURN VALUE

42       Returns CURLE_OK if false start is supported by the SSL backend, other‐
43       wise returns CURLE_NOT_BUILT_IN.
44
45
46
47libcurl 7.76.1                 November 04, 2020     CURLOPT_SSL_FALSESTART(3)
Impressum