curl/docs/cmdline-opts/ftp-port.md
Daniel Stenberg fe9f68fa61
cmdline-opts: shorter help texts
In an effort to increase the readability of the "--help all" output on
narrow (80 column) terminals.

Co-authored-by: Jay Satiro

Closes #13169
2024-03-25 13:05:24 +01:00

1.5 KiB

c SPDX-License-Identifier Long Arg Help Short Protocols Category Added Multi See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl ftp-port <address> Send PORT instead of PASV P FTP ftp 4.0 single
ftp-pasv
disable-eprt
-P - ftp:/example.com
-P eth0 ftp:/example.com
-P 192.168.0.2 ftp:/example.com

--ftp-port

Reverses the default initiator/listener roles when connecting with FTP. This option makes curl use active mode. curl then commands the server to connect back to the client's specified address and port, while passive mode asks the server to setup an IP address and port for it to connect to. <address> should be one of:

interface

e.g. eth0 to specify which interface's IP address you want to use (Unix only)

IP address

e.g. 192.168.10.1 to specify the exact IP address

hostname

e.g. my.host.domain to specify the machine

-

make curl pick the same IP address that is already used for the control connection. This is the recommended choice.

Disable the use of PORT with --ftp-pasv. Disable the attempt to use the EPRT command instead of PORT by using --disable-eprt. EPRT is really PORT++.

You can also append ":[start]-[end]" to the right of the address, to tell curl what TCP port range to use. That means you specify a port range, from a lower to a higher number. A single number works as well, but do note that it increases the risk of failure since the port may not be available. (Added in 7.19.5)