CURLOPT_SSL_FALSESTART.md (1278B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLOPT_SSL_FALSESTART 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLOPT_TCP_FASTOPEN (3) 9 Protocol: 10 - TLS 11 TLS-backend: 12 - none 13 Added-in: 7.42.0 14 --- 15 16 # NAME 17 18 CURLOPT_SSL_FALSESTART - TLS false start 19 20 # SYNOPSIS 21 22 ~~~c 23 #include <curl/curl.h> 24 25 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_FALSESTART, long enable); 26 ~~~ 27 28 # DESCRIPTION 29 30 Pass a long as parameter set to 1L to enable or 0 to disable. 31 32 This option determines whether libcurl should use false start during the TLS 33 handshake. False start is a mode where a TLS client starts sending application 34 data before verifying the server's Finished message, thus saving a round trip 35 when performing a full handshake. 36 37 # DEFAULT 38 39 0 40 41 # %PROTOCOLS% 42 43 # EXAMPLE 44 45 ~~~c 46 int main(void) 47 { 48 CURL *curl = curl_easy_init(); 49 if(curl) { 50 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); 51 curl_easy_setopt(curl, CURLOPT_SSL_FALSESTART, 1L); 52 curl_easy_perform(curl); 53 } 54 } 55 ~~~ 56 57 # DEPRECATED 58 59 Deprecated since 8.15.0. 60 61 # %AVAILABILITY% 62 63 # RETURN VALUE 64 65 curl_easy_setopt(3) returns a CURLcode indicating success or error. 66 67 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 68 libcurl-errors(3).