CURLOPT_ACCEPTTIMEOUT_MS(3)

💅 CURLOPT_ACCEPTTIMEOUT_MS(3) 💅

okay so bestie, this page is from the Library Functions Manual and it's all about CURLOPT_ACCEPTTIMEOUT_MS — long name, iconic behavior, lowkey niche. no cap. 🎀

✨ NAME ✨

CURLOPT_ACCEPTTIMEOUT_MS — timeout waiting for FTP server to connect back. It's giving "how long do we wait for the server to text back" energy, but make it FTP. 🫶

🛠️ SYNOPSIS 🛠️

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ACCEPTTIMEOUT_MS, long ms);

🌸 DESCRIPTION 🌸

Pass a long telling libcurl the maximum number of milliseconds to wait for a server to connect back to libcurl when an active FTP connection is used. With active FTP, the client (that's libcurl) tells the server to do a TCP connect back to the client, instead of vice versa for passive FTP. The way that libcurl is out here making the server call it back? main character energy, honestly. 👑

This option has no purpose for passive FTP. Not me looking for relevance where there is none. 💀

🍓 DEFAULT 🍓

60000 milliseconds

🦋 PROTOCOLS 🦋

This functionality affects ftp only. fr fr, vibe check passed: FTP only, periodt. 🦋

🔥 EXAMPLE 🔥

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/path/file");

    /* wait no more than 5 seconds for the FTP server to connect */
    curl_easy_setopt(curl, CURLOPT_ACCEPTTIMEOUT_MS, 5000L);

    curl_easy_perform(curl);
  }
}

⭐ AVAILABILITY ⭐

Added in curl 7.24.0. so she's been around, okay? vintage but still serving. 💜

💖 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). That's the whole vibe: 0 is slay, non-zero is highkey "bestie something went off". 😭

🌈 SEE ALSO 🌈

• CURLOPT_CONNECTTIMEOUT_MS(3)
• CURLOPT_DEBUGFUNCTION(3)
• CURLOPT_FTPPORT(3)
• CURLOPT_STDERR(3)

xoxo, later bestie — this was CURLOPT_ACCEPTTIMEOUT_MS(3) from libcurl, dated 2026-10-12. mwah 💖