From 1160380e5035bef181f60911a45ad41b39fa02a0 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Sat, 26 Oct 2024 23:13:02 +0200 Subject: [PATCH] docs: clarify FTP over HTTP proxy functionality somewhat Reported-by: newfunction Closes #15417 --- docs/cmdline-opts/proxy.md | 4 ++++ docs/libcurl/opts/CURLOPT_PROXY.md | 4 ++++ 2 files changed, 8 insertions(+) diff --git a/docs/cmdline-opts/proxy.md b/docs/cmdline-opts/proxy.md index 529d3369fb..afaa29837e 100644 --- a/docs/cmdline-opts/proxy.md +++ b/docs/cmdline-opts/proxy.md @@ -56,3 +56,7 @@ password. When a proxy is used, the active FTP mode as set with --ftp-port, cannot be used. + +Doing FTP over an HTTP proxy without --proxytunnel makes curl do HTTP with an +FTP URL over the proxy. For such transfers, common FTP specific options do not +work, including --ftp-ssl-reqd and --ftp-ssl-control. diff --git a/docs/libcurl/opts/CURLOPT_PROXY.md b/docs/libcurl/opts/CURLOPT_PROXY.md index c414f4f512..7c84556024 100644 --- a/docs/libcurl/opts/CURLOPT_PROXY.md +++ b/docs/libcurl/opts/CURLOPT_PROXY.md @@ -102,6 +102,10 @@ single port number used widely for proxies. Specify it. When a proxy is used, the active FTP mode as set with *CUROPT_FTPPORT(3)*, cannot be used. +Doing FTP over an HTTP proxy without CURLOPT_HTTPPROXYTUNNEL(3) set makes +libcurl do HTTP with an FTP URL over the proxy. For such transfers, common FTP +specific options do not work, for example CURLOPT_USE_SSL(3). + # Environment variables libcurl respects the proxy environment variables named **http_proxy**,