curl/docs/cmdline-opts/socks4a.d

Long: socks4a
Arg: <host[:port]>
Help: SOCKS4a proxy on given host + port
Added: 7.18.0
Category: proxy
Example: --socks4a hostname:4096 $URL
See-also: socks4 socks5 socks5-hostname
---
Use the specified SOCKS4a proxy. If the port number is not specified, it is
assumed at port 1080. This asks the proxy to resolve the host name.

This option overrides any previous use of --proxy, as they are mutually
exclusive.

This option is superfluous since you can specify a socks4a proxy with --proxy
using a socks4a:// protocol prefix. (Added in 7.21.7)

Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time
--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to
the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.

If this option is used several times, the last one will be used.
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 02:50:25 +03:00			`Long: socks4a`
			`Arg: <host[:port]>`
			`Help: SOCKS4a proxy on given host + port`
			`Added: 7.18.0`
docs: add categories to all cmdline opts Adapted gen.pl with 'listcats' This commit is a part of "--help me if you can" Closes #5680 2020-07-13 15:15:04 +03:00			`Category: proxy`
curl.1: provide examples for each option The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654 2021-08-31 17:37:14 +03:00			`Example: --socks4a hostname:4096 $URL`
curl.1: require "see also" for every documented option gen.pl now generates a warning if the "See Also" field is not filled in for a command line option All command line options now provide one or more related options. 167 "See alsos" added! Closes #8019 2021-11-15 17:58:20 +03:00			`See-also: socks4 socks5 socks5-hostname`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 02:50:25 +03:00			`---`
			`Use the specified SOCKS4a proxy. If the port number is not specified, it is`
--socks4[a]: clarify where the host name is resolved Closes #7273 2021-06-17 18:26:36 +03:00			`assumed at port 1080. This asks the proxy to resolve the host name.`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 02:50:25 +03:00
cmdline-opts/socks: Mention --preproxy in --socks opts - Document in --socks* opts they're still mutually exclusive of --proxy. Partial revert of 423a93c; I had misinterpreted the SOCKS proxy + HTTP/HTTPS proxy combination. - Document in --socks* opts that --preproxy can be used to specify a SOCKS proxy at the same time --proxy is used with an HTTP/HTTPS proxy. 2017-02-10 02:26:16 +03:00			`This option overrides any previous use of --proxy, as they are mutually`
			`exclusive.`

curl.1: remove mentions of really old version changes To make the man page more readable, this change removes all references to changes in support/versions etc that happened before 7.30.0 from the curl.1 output file. 7.30.0 was released on Apr 12 2013. This particular limit is a bit arbitrary but was fairly easy to grep for. It is handled like this: the 'Added' keyword is only used in output if it refers to 7.30.0 or later. All occurances of "(Added in $VERSION)" in description will be stripped out if the mentioned $VERSION is from before 7.30.0. It is therefore important that the "Added in..." references are always written exactly like that - and on a single line, not split over two. This change removes about 80 version number references from curl.1, down to 138 from 218. Closes #7786 2021-09-28 11:30:59 +03:00			`This option is superfluous since you can specify a socks4a proxy with --proxy`
			`using a socks4a:// protocol prefix. (Added in 7.21.7)`
cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 02:50:25 +03:00
cmdline-opts/socks: Mention --preproxy in --socks opts - Document in --socks* opts they're still mutually exclusive of --proxy. Partial revert of 423a93c; I had misinterpreted the SOCKS proxy + HTTP/HTTPS proxy combination. - Document in --socks* opts that --preproxy can be used to specify a SOCKS proxy at the same time --proxy is used with an HTTP/HTTPS proxy. 2017-02-10 02:26:16 +03:00			`Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at the same time`
			`--proxy is used with an HTTP/HTTPS proxy. In such a case curl first connects to`
docs: Add more HTTPS proxy documentation - Document HTTPS proxy type. - Document --write-out %{proxy_ssl_verify_result}. - Document SOCKS proxy + HTTP/HTTPS proxy combination. HTTPS proxy support was added in 7.52.0 for OpenSSL, GnuTLS and NSS. Ref: https://github.com/curl/curl/commit/cb4e2be 2017-02-06 11:13:42 +03:00			`the SOCKS proxy and then connects (through SOCKS) to the HTTP or HTTPS proxy.`

cmdline-opts: more command line options documented Moved over to the new format 2016-11-28 02:50:25 +03:00			`If this option is used several times, the last one will be used.`