curl/docs/cmdline-opts/ftp-port.md
Daniel Stenberg e7219c2bdc
cmdline-opts: language cleanups
Use imperative mood consistently for the first sentence describing an
option.

"Set this" instead "tell curl to set" or "this sets..."

Plus some extra cleanups and rephrasing.

Closes #13106
2024-03-12 15:42:33 +01:00

52 lines
1.5 KiB
Markdown

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