Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_FTP_SKIP_PASV_IP(3) Library Functions Manual CURLOPT_FTP_SKIP_PASV_IP(3)

NAME
     CURLOPT_FTP_SKIP_PASV_IP - 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
     Pass  a  long.  If skip is set to 1, it instructs libcurl to not use the IP
     address the server suggests in its 227-response to libcurl's  PASV  command
     when  libcurl connects the data connection. Instead libcurl reuses the same
     IP address it already uses for the control connection. It	still  uses  the
     port number from the 227-response.

     This  option  allows  libcurl to work around broken server installations or
     funny network setups that due to NATs, firewalls or incompetence report the
     wrong IP address. Setting this option also reduces  the  risk  for  various
     sorts of client abuse by malicious servers.

     This option has no effect if PORT, EPRT or EPSV is used instead of PASV.

DEFAULT
     1, enabled.

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);
       }
     }

HISTORY
     Before curl 7.74.0, this option was disabled by default.

AVAILABILITY
     Added in curl 7.15.0

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_FTPPORT(3), CURLOPT_FTP_USE_EPRT(3)

libcurl 			   2026-06-11	     CURLOPT_FTP_SKIP_PASV_IP(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_FTP_SKIP_PASV_IP&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help