Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Whether to use ASCII mode for FTP transfer.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CURL 2.5 Yes Yes Yes Yes Yes
MBS( "CURL.SetOptionTransferText"; curl; Value )   More


Parameter Description Example value
curl The CURL session handle. $curl
Value Whether to use ASCII mode. 1


Returns "OK" on success.


Whether to use ASCII mode for FTP transfer.
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.

See also TRANSFERTEXT option in CURL manual.


Set transfer mode to binary data:

MBS( "CURL.SetOptionTransferText"; $curl; 0 )

Set transfer mode to text:

MBS( "CURL.SetOptionTransferText"; $curl; 1 )

See also

Created 18th August 2014, last changed 7th December 2016

CURL.SetOptionTransferEncoding   -   CURL.SetOptionURL

Feedback: Report problem or ask question.

MBS FileMaker blog