CURL.SetOptionFTPPort
---------------------

Sets the ports to use for FTP.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [CURL](component_CURL.md) | [2.5](newinversion25.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "CURL.SetOptionFTPPort"; curl; Value { ; Encoding } ) 

**MBS**( **"CURL.SetOptionFTPPort";** /\* Sets the ports to use for FTP. \*/  
**$curl**; /\* The CURL session handle. \*/   
**$Value**; /\* The port string.e.g. "" \*/   
**$Encoding**) /\* Optional; The text encoding for text parameter.   
Default is UTF-8.e.g. "UTF-8" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| curl | The CURL session handle. | $curl |  |
| Value | The port string. | "" |  |
| Encoding | The text encoding for text parameter.    Default is UTF-8.   Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the [FAQ](https://www.monkeybreadsoftware.com/filemaker/faq.shtml). | "UTF-8" | Optional |

### Result

Returns "OK" on success.

### Description

Sets the ports to use for FTP.  
It will be used to get the IP address to use for the FTP PORT instruction. The PORT instruction tells the remote server to connect to our specified IP address. The string may be a plain IP address, a host name, a network interface name (under Unix) or just a '-' symbol to let the library use your system's default IP address. Default FTP operations are passive, and thus won't use PORT.  
  
The address can be followed by a ':' to specify a port, optionally followed by a '-' to specify a port range. If the port specified is 0, the operating system will pick a free port. If a range is provided and all ports in the range are not available, libcurl will report CURLE\_FTP\_PORT\_FAILED for the handle. Invalid port/range settings are ignored. IPv6 addresses followed by a port or portrange have to be in brackets. IPv6 addresses without port/range specifier can be in brackets.  
  
Examples with specified ports:  
  
 eth0:0 192.168.1.2:32000-33000 curl.se:32123 \[::1\]:1234-4567  
  
You disable PORT again and go back to using the passive version by setting this option to empty string.  
See also [CURL.SetOptionPort](CURLSetOptionPort.md).  
See also [FTPPORT](https://curl.haxx.se/libcurl/c/CURLOPT_FTPPORT.html) option in CURL manual.

### Examples

Sets to use default port:

 MBS ( "CURL.SetOptionFTPPort"; $curl ; "-")  
### See also

- [CURL.SetOptionPassword](CURLSetOptionPassword.md)
- [CURL.SetOptionPort](CURLSetOptionPort.md)
- [CURL.SetOptionPost](CURLSetOptionPost.md)
- [CURL.SetOptionPreProxy](CURLSetOptionPreProxy.md)
- [CURL.SetOptionProxy](CURLSetOptionProxy.md)
- [CURL.SetOptionProxyPort](CURLSetOptionProxyPort.md)
- [CURL.SetOptionPut](CURLSetOptionPut.md)
- [CURL.SetOptionSSLCert](CURLSetOptionSSLCert.md)
- [CURL.SetOptionTimeOut](CURLSetOptionTimeOut.md)
- [CURL.SetOptionVerbose](CURLSetOptionVerbose.md)

### Blog Entries

- [Translating Insert from URL options for CURL to MBS Plugin calls](https://www.mbsplugins.de/archive/2020-12-14/Translating_Insert_from_URL_op/monkeybreadsoftware_blog_filemaker)

Created 18th August 2014 , last changed 19th June 2019

  
[CURL.SetOptionFTPFileMethod](CURLSetOptionFTPFileMethod.md) - [CURL.SetOptionFTPSSLAuth](CURLSetOptionFTPSSLAuth.md)

[HTML Version](CURLSetOptionFTPPort.shtml)