CURLOPT_TRANSFERTEXT(3)

CURLOPT_TRANSFERTEXT(3curl_easy_setopt optionCURLOPT_TRANSFERTEXT(3)

NAME

     CURLOPT_TRANSFERTEXT - request a text based transfer for FTP

SYNOPSIS

     #include <curl/curl.h>

     CURLcode           curl_easy_setopt(CURL            *handle,
     CURLOPT_TRANSFERTEXT, long text);

DESCRIPTION

     A parameter set to 1 tells the library to use ASCII mode for
     FTP  transfers,  instead of the default binary transfer. For
     win32 systems it does not set the  stdout  to  binary  mode.
     This  option  can  be  usable  when  transferring  text data
     between systems with different views on certain  characters,
     such as newlines or similar.

     libcurl does not do a complete ASCII conversion  when  doing
     ASCII  transfers  over  FTP. This is a known limitation/flaw
     that nobody has rectified. libcurl simply sets the  mode  to
     ASCII and performs a standard transfer.

DEFAULT

     0, disabled

PROTOCOLS

     FTP

EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/textfile");
       curl_easy_setopt(curl, CURLOPT_TRANSFERTEXT, 1L);
       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_CRLF(3),

libcurl 7.58.0      Last change: May 31, 2017                   1