Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

CURLOPT_FTP_USE_EPRT (3)

Name

CURLOPT_FTP_USE_EPRT - use EPRT for FTP

Synopsis

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPRT, long enabled);

Description

CURLOPT_FTP_USE_EPRT(3)    curl_easy_setopt options    CURLOPT_FTP_USE_EPRT(3)



NAME
       CURLOPT_FTP_USE_EPRT - use EPRT for FTP

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FTP_USE_EPRT, long enabled);

DESCRIPTION
       Pass  a  long. If the value is 1, it tells curl to use the EPRT command
       when doing active FTP  downloads  (which  is  enabled  by  CURLOPT_FTP-
       PORT(3)).  Using  EPRT  means  that  it  will first attempt to use EPRT
       before using PORT, but if you pass zero to this option, it will not try
       using EPRT, only plain PORT.

       If  the server is an IPv6 host, this option will have no effect as EPRT
       is necessary then.

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

         /* contact us back, aka "active" FTP */
         curl_easy_setopt(curl, CURLOPT_FTPPORT, "-");

         /* FTP the way the neanderthals did it */
         curl_easy_setopt(curl, CURLOPT_FTP_USE_EPRT, 0L);

         ret = curl_easy_perform(curl);

         curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in 7.10.5

RETURN VALUE
       Returns CURLE_OK


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       CURLOPT_FTP_USE_EPSV(3), CURLOPT_FTPPORT(3),



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source      was      downloaded       from        https://curl.se/down-
       load/curl-7.83.1.tar.bz2.

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



libcurl 7.83.1                 November 26, 2021       CURLOPT_FTP_USE_EPRT(3)