CURLOPT_FTP_SKIP_PASV_IP(3)

💅 CURLOPT_FTP_SKIP_PASV_IP(3) 💅

okay so real quick — this is a page from the Library Functions Manual, and the star of the show is CURLOPT_FTP_SKIP_PASV_IP, iykyk ✨

---

🎀 NAME 🎀

CURLOPT_FTP_SKIP_PASV_IP — bestie, it literally means: ignore the IP address in the PASV response 🙈

---

🌸 SYNOPSIS 🌸

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_SKIP_PASV_IP, long skip);

---

🦋 DESCRIPTION 🦋

So you pass a long, right? And if skip is set to 1, you're telling libcurl: do not use the IP address that the server suggests in its 227-response to libcurl's PASV command when libcurl connects the data connection. Nope. Not today. 💅

Instead, libcurl reuses the exact same IP address it's already using for the control connection. Periodt. But — and this is important — it still uses the port number from the 227-response. So the port stays, only the IP gets the skip treatment ✨

Why does this matter? Because this option lets libcurl work around broken server installations or, like, funny network setups that go around reporting the wrong IP address thanks to NATs, firewalls, or honestly just plain incompetence 😭 Setting this option also reduces the risk for various sorts of client abuse by malicious servers, which is lowkey a slay for your security 🫶

heads up: this option has no effect if PORT, EPRT or EPSV is used instead of PASV. Like, zero. none. don't come for me 💀

---

⭐ DEFAULT ⭐

1 since 7.74.0, was 0 before then. the glow-up is real 👑

---

🌈 PROTOCOLS 🌈

This functionality affects ftp only 🐟

---

💖 EXAMPLE 💖

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

    /* please ignore the IP in the PASV response */
    curl_easy_setopt(curl, CURLOPT_FTP_SKIP_PASV_IP, 1L);
    result = curl_easy_perform(curl);

    curl_easy_cleanup(curl);
  }
}

look at that comment — please ignore the IP in the PASV response — she's so polite about it 🥹

---

🧚 AVAILABILITY 🧚

Added in curl 7.15.0 — vintage, but make it iconic 💜

---

💅 RETURN VALUE 💅

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

CURLE_OK (0) means everything was OK 😌 and non-zero means an error occurred — go check libcurl-errors(3) for the deets 🔥

---

🍓 SEE ALSO 🍓

• CURLOPT_FTPPORT(3)
• CURLOPT_FTP_USE_EPRT(3)

---

and that's the whole vibe check, bestie 🎀 this page came from libcurl, dated 2026-10-12 — CURLOPT_FTP_SKIP_PASV_IP(3), out ✌️💖