GNURLOPT_SSLKEYTYPE(3)

💅 GNURLOPT_SSLKEYTYPE(3) 💅

okay bestie, this is the GNURLOPT_SSLKEYTYPE(3) page, hanging out in the curl_easy_setopt options manual section — and it's here to explain setting the type of your private key file. no cap. ✨

---

🌸 NAME 🌸

CURLOPT_SSLKEYTYPE — set type of the private key file 💖

🎀 SYNOPSIS 🎀

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSLKEYTYPE, char *type);

🦋 DESCRIPTION 🦋

You pass a pointer to a null-terminated string as parameter — that string is, like, the format of your private key. Supported formats are "PEM", "DER" and "ENG". 💅

The format "ENG" enables you to load the private key from a crypto engine. In this case CURLOPT_SSLKEY(3) is used as an identifier passed to the engine. You have to set the crypto engine with CURLOPT_SSLENGINE(3). 🧚

The "DER" format key file currently does not work because of a bug in OpenSSL — not the vibe, but that's the tea. 💀

The application does not have to keep the string around after setting this option, so don't stress about keeping it alive afterward. 🫶

✨ DEFAULT ✨

"PEM" — that's the default, periodt. 👑

🌈 PROTOCOLS 🌈

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

🔥 EXAMPLE 🔥

like, here's the whole vibe:

CURL *curl = curl_easy_init();
if(curl) {
  curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/");
  curl_easy_setopt(curl, CURLOPT_SSLCERT, "client.pem");
  curl_easy_setopt(curl, CURLOPT_SSLKEY, "key.pem");
  curl_easy_setopt(curl, CURLOPT_SSLKEYTYPE, "PEM");
  curl_easy_setopt(curl, CURLOPT_KEYPASSWD, "s3cret");
  ret = curl_easy_perform(curl);
  curl_easy_cleanup(curl);
}

🧚 AVAILABILITY 🧚

Available if built TLS enabled — that's the condition, bestie. ✨

💜 RETURN VALUE 💜

Returns CURLE_OK if TLS is supported, CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there was insufficient heap space. 🫶

🍓 SEE ALSO 🍓

• CURLOPT_SSLKEY(3), CURLOPT_SSLCERT(3), — go peek at these too, bestie 💖

---

mwah 💋 — this page is from libcurl 7.37.0, dated 17 Jun 2014, and it's still the GNURLOPT_SSLKEYTYPE(3) manual page. byeee bestie 🫶✨