CURLOPT_FTPSSLAUTH(3)

💅 CURLOPT_FTPSSLAUTH 💅

ok so this is a page from the libcurl manual (Library Functions Manual), and it's about CURLOPT_FTPSSLAUTH — the icon of "which one do we try first, TLS or SSL?" ✨

---

🌸 NAME 🌸

CURLOPT_FTPSSLAUTH — the order in which to attempt TLS vs SSL 🎀

---

🦋 SYNOPSIS 🦋

#include <curl/curl.h>

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

---

✨ DESCRIPTION ✨

bestie, you pass a long in here using one of the values from below 👇 and it alters how libcurl issues "AUTH TLS" or "AUTH SSL" when FTP over SSL is activated. basically you're deciding who goes first, no cap.

heads up: this is only interesting if CURLOPT_USE_SSL(3) is also set. otherwise it's just sitting there, main character energy with no plot 😭

Possible order values:

• CURLFTPAUTH_DEFAULT — let libcurl decide, she's got this 💅
• 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

(the classic "libcurl knows best" vibe 💖)

---

🌈 PROTOCOLS 🌈

idk this one's exclusive — this functionality affects ftp only 🐟

---

🔥 EXAMPLE 🔥

here's the whole thing, literally:

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    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);
    result = curl_easy_perform(curl);
    curl_easy_cleanup(curl);
  }
}

see that comment? /* funny server, ask for SSL before TLS */ — yeah, sometimes the server's just quirky like that 🫶

---

🧚 HISTORY 🧚

ok so lore drop 📖: the CURLFTPAUTH_* enums became long types in 8.16.0. prior to this version a long cast was necessary when passed to curl_easy_setopt(3). so if you're on old code and seeing casts, that's why, iykyk 💀

---

⭐ AVAILABILITY ⭐

added in curl 7.12.2 — vintage but still slaying 👑

---

💜 RETURN VALUE 💜

curl_easy_setopt(3) returns a CURLcode indicating success or error.

• CURLE_OK (0) means everything was OK 🎉
• non-zero means an error occurred 😭 — see libcurl-errors(3)

---

🍓 SEE ALSO 🍓

• CURLOPT_FTP_SSL_CCC(3)
• CURLOPT_USE_SSL(3)

---

that's the whole page bestie, go configure something iconic 💅✨

sign-off szn: this was the libcurl manual page, dated 2026-10-12 🌸 — catch you on the next one, love u 🫶