aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/ftp-port.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cmdline-opts/ftp-port.md')
-rw-r--r--docs/cmdline-opts/ftp-port.md51
1 files changed, 51 insertions, 0 deletions
diff --git a/docs/cmdline-opts/ftp-port.md b/docs/cmdline-opts/ftp-port.md
new file mode 100644
index 000000000..e9ec59146
--- /dev/null
+++ b/docs/cmdline-opts/ftp-port.md
@@ -0,0 +1,51 @@
+---
+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 tells 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
+
+## host name
+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)