moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-08-13 17:03:50 -04:00
Code Issues Releases Wiki Activity

Markus Koetter's man page updates for the FTPPORT ranges

Browse Source
This commit is contained in:
Daniel Stenberg 2009-07-08 07:20:42 +00:00
parent 5cf78472e1
commit f3403d4c5b
1 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/libcurl/curl_easy_setopt.3
View File

@ -1070,11 +1070,22 @@ 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 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. address. Default FTP operations are passive, and thus won't use PORT.
Starting in 7.19.5, you can append \&":[start]-[end]\&" to the right of the The address can be followed by a ':' to specify a port, optionally followed by
address, to tell libcurl what TCP port range to use. That means you specify a a '-' to specify a port range. If the port specified is 0, the operating
port range, from a lower to a higher number. A single number works as well, system will pick a free port. If a range is provided and all ports in the
but do note that it increases the risk of failure since the port may not be range are not available, libcurl will report CURLE_FTP_PORT_FAILED for the
available. 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. (added in 7.19.5)
Examples with specified ports:
.nf
eth0:0
192.168.1.2:32000-33000
curl.se:32123
[::1]:1234-4567
.fi
You disable PORT again and go back to using the passive version by setting You disable PORT again and go back to using the passive version by setting
this option to NULL. this option to NULL.