GNURLOPT_TLSAUTH_PASSWORD(3)

🌸 NAME 🌸

okay bestie, this page is GNURLOPT_TLSAUTH_PASSWORD(3), part of the curl_easy_setopt options family, and the actual option is CURLOPT_TLSAUTH_PASSWORD — password to use for TLS authentication. no cap, that's the whole name vibe.

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_PASSWORD, char
*pwd);

🦋 DESCRIPTION 🦋

so you pass a char * as the parameter, bestie — it should point to the null-terminated password for the TLS authentication method you specified with the CURLOPT_TLSAUTH_TYPE(3) option. this option also requires that the CURLOPT_TLSAUTH_USERNAME(3) option be set too. fr fr, both of them.

the application does not have to keep the string around after setting this option, which is lowkey convenient — it's giving set-and-forget energy, icon behavior.

⚠️ heads up: this feature relies on TLS SRP, and TLS SRP doesn't work with TLS 1.3. so if you're on TLS 1.3, this one's not gonna slay for you.

🎀 DEFAULT 🎀

NULL

🌈 PROTOCOLS 🌈

All TLS-based protocols

🍓 EXAMPLE 🍓

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_TLSAUTH_TYPE, "SRP");
  curl_easy_setopt(curl, CURLOPT_TLSAUTH_USERNAME, "user");
  curl_easy_setopt(curl, CURLOPT_TLSAUTH_PASSWORD, "secret");
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

🦋 AVAILABILITY 🦋

Added in 7.21.4

💜 RETURN VALUE 💜

Returns CURLE_OK if the option is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. literally the whole return value tea, periodt.

🍓 SEE ALSO 🍓

CURLOPT_TLSAUTH_TYPE(3), CURLOPT_TLSAUTH_USERNAME(3), — yes bestie, go read those too, iykyk.

---

okay that's the whole page, bestie 🫶 — this one came from libcurl 7.37.0, dated 19 Jun 2014, and the page is GNURLOPT_TLSAUTH_PASSWORD(3). periodt 💅✨