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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_TRANSFERTEXT(3)	   Library Functions Manual    CURLOPT_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	trans-
       fers, 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	trans-
       fers  over  FTP.	This is	a known	limitation/flaw	that nobody has	recti-
       fied. libcurl simply sets the mode to ASCII  and	 performs  a  standard
       transfer.

DEFAULT
       0, disabled

PROTOCOLS
       This functionality affects all supported	protocols

EXAMPLE
       int main(void)
       {
	 CURL *curl = curl_easy_init();
	 if(curl) {
	   CURLcode res;
	   curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/textfile");
	   curl_easy_setopt(curl, CURLOPT_TRANSFERTEXT,	1L);
	   res = curl_easy_perform(curl);
	   curl_easy_cleanup(curl);
	 }
       }

AVAILABILITY
       Added in	curl 7.1.1

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_CRLF(3)

libcurl				  2025-06-03	       CURLOPT_TRANSFERTEXT(3)

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

home | help