GNURLOPT_SSL_FALSESTART(3)

💅 GNURLOPT_SSL_FALSESTART(3) 💅

okay bestie, welcome to the curl_easy_setopt options manual page — this one is all about CURLOPT_SSL_FALSESTART, aka the switch that lets you enable TLS false start. Let's go, it's giving TLS handshake energy. 🦋✨

---

🌸 NAME 🌸

CURLOPT_SSL_FALSESTART — enable TLS false start 💅

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_FALSESTART, long
       enable);

💖 DESCRIPTION 💖

okay so you pass a long as the parameter — set it to 1L to enable, or 0 to disable. That's the whole vibe.

This option determines whether libcurl should use false start during the TLS handshake. False start is a mode where a TLS client will start sending application data before verifying the server's Finished message — the way that saves a round trip when performing a full handshake. Slay. 🎀

🎀 DEFAULT 🎀

Default: 0 — off by default, bestie. 💤

🌈 PROTOCOLS 🌈

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

🍓 EXAMPLE 🍓

Here's the code, literally:

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
  curl_easy_setopt(curl, CURLOPT_SSL_FALSESTART, 1L);
  curl_easy_perform(curl);
}

💜 AVAILABILITY 💜

Added in 7.42.0. This option is currently only supported by the NSS and Secure Transport (on iOS 7.0 or later, or OS X 10.9 or later) TLS backends. 🫶

👑 RETURN VALUE 👑

Returns CURLE_OK if false start is supported by the SSL backend, otherwise returns CURLE_NOT_BUILT_IN. So if your backend isn't built for it, you get CURLE_NOT_BUILT_IN — not a vibe, but at least it's clear. 💀

---

okay that's the whole page, bestie. This one came from libcurl 7.41.0, dated 14 Feb 2015 — mwah 💋✨