Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

CURLOPT_FTP_USE_EPSV (3)

Name

CURLOPT_FTP_USE_EPSV - enable/disable use of EPSV

Synopsis

#include <curl/curl.h>

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

Description

CURLOPT_FTP_USE_EPSV(3)    curl_easy_setopt options    CURLOPT_FTP_USE_EPSV(3)



NAME
       CURLOPT_FTP_USE_EPSV - enable/disable use of EPSV

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 it will first attempt to use  EPSV  before  using
       PASV,  but if you pass zero to this option, it will not try using EPSV,
       only plain PASV.

       If the server is an IPv6 host, this option will have no  effect  as  of
       7.12.3.

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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       CURLOPT_FTP_USE_EPRT(3), CURLOPT_FTPPORT(3),



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded    from    https://github.com/curl/curl/ar-
       chive/curl-7_64_0.zip

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.



libcurl 7.37.0                    17 Jun 2014          CURLOPT_FTP_USE_EPSV(3)