OpenSuSE Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
x SuSE Linux 13.1-RELEASE x
x SuSE Linux 13.1-RELEASEx
CURLOPT_FTP_USE_EPSV(3)             libcurl            CURLOPT_FTP_USE_EPSV(3)

NAME
       CURLOPT_FTP_USE_EPSV - use EPSV for FTP

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPSV, long epsv);

DESCRIPTION
       Pass  epsv  as a long. If the value is 1, it tells curl to use the EPSV
       command when doing passive FTP downloads (which it  does  by  default).
       Using  EPSV  means  that libcurl first attempts to use the EPSV command
       before using PASV. If you pass zero to this option,  it  does  not  use
       EPSV, only plain PASV.

       The  EPSV command is a slightly newer addition to the FTP protocol than
       PASV and is the preferred command to use since it enables  IPv6  to  be
       used.  Very  old FTP servers might not support it, which is why libcurl
       has a fallback mechanism. Sometimes that fallback  is  not  enough  and
       then this option might come handy.

       If the server is an IPv6 host, this option has no effect.

DEFAULT
       1

PROTOCOLS
       FTP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/old-server/file.txt");

         /* let's shut off this modern feature */
         curl_easy_setopt(curl, CURLOPT_FTP_USE_EPSV, 0L);

         ret = curl_easy_perform(curl);

         curl_easy_cleanup(curl);
       }

AVAILABILITY
       Along with FTP

RETURN VALUE
       Returns CURLE_OK if FTP is supported, and CURLE_UNKNOWN_OPTION if not.

SEE ALSO
       CURLOPT_FTP_USE_EPRT(3), CURLOPT_FTPPORT(3)

ibcurl 8.4.0                  September 26, 2023       CURLOPT_FTP_USE_EPSV(3)

Want to link to this manual page? Use this URL:
<
http://star2.abcm.com/cgi-bin/bsdi-man?query=CURLOPT_FTP_USE_EPSV&sektion=3&manpath=>

home | help