GNURLOPT_FTPSSLAUTH(3)

💖 NAME 💖

Okay bestie 💖 you're on GNURLOPT_FTPSSLAUTH(3) from the curl_easy_setopt options manual. The actual option here is CURLOPT_FTPSSLAUTH — it sets the order in which to attempt TLS vs SSL when using FTP. That's the tea.

---

✨ SYNOPSIS ✨

#include <gnurl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTPSSLAUTH, long order);

---

💅 DESCRIPTION 💅

Pass a long using one of the values from below, bestie. It alters how libcurl issues "AUTH TLS" or "AUTH SSL" when FTP over SSL is activated. This is only interesting if CURLOPT_USE_SSL(3) is also set — iykyk.

Possible order values:

• CURLFTPAUTH_DEFAULT — allow libcurl to decide. Main character energy, honestly.
• CURLFTPAUTH_SSL — try "AUTH SSL" first, and only if that fails try "AUTH TLS".
• CURLFTPAUTH_TLS — try "AUTH TLS" first, and only if that fails try "AUTH SSL".

---

🎀 DEFAULT 🎀

CURLFTPAUTH_DEFAULT — that's the default, periodt.

---

🌈 PROTOCOLS 🌈

FTP — that's it.

---

🔥 EXAMPLE 🔥

Here's the example, exactly as the page serves it:

       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/file.txt");
         curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_TRY);
         /* funny server, ask for SSL before TLS */
         curl_easy_setopt(curl, CURLOPT_FTPSSLAUTH, CURLFTPAUTH_SSL);
         ret = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
       }

---

⭐ AVAILABILITY ⭐

Added in 7.12.2 — vintage but still cute.

---

💜 RETURN VALUE 💜

Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. Simple.

---

🫶 SEE ALSO 🫶

Go give these a lil read:

• CURLOPT_USE_SSL(3)
• CURLOPT_FTP_SSL_CCC(3),

---

That's the whole page, bestie 💖 it's from libcurl 7.37.0, dated 19 Jun 2014, and its manual-page name is GNURLOPT_FTPSSLAUTH(3). Mwah 🧚✨