xref: /aosp_15_r20/external/curl/docs/cmdline-opts/socks4a.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: socks4a
5*6236dae4SAndroid Build Coastguard WorkerArg: <host[:port]>
6*6236dae4SAndroid Build Coastguard WorkerHelp: SOCKS4a proxy on given host + port
7*6236dae4SAndroid Build Coastguard WorkerAdded: 7.18.0
8*6236dae4SAndroid Build Coastguard WorkerCategory: proxy
9*6236dae4SAndroid Build Coastguard WorkerMulti: single
10*6236dae4SAndroid Build Coastguard WorkerSee-also:
11*6236dae4SAndroid Build Coastguard Worker  - socks4
12*6236dae4SAndroid Build Coastguard Worker  - socks5
13*6236dae4SAndroid Build Coastguard Worker  - socks5-hostname
14*6236dae4SAndroid Build Coastguard WorkerExample:
15*6236dae4SAndroid Build Coastguard Worker  - --socks4a hostname:4096 $URL
16*6236dae4SAndroid Build Coastguard Worker---
17*6236dae4SAndroid Build Coastguard Worker
18*6236dae4SAndroid Build Coastguard Worker# `--socks4a`
19*6236dae4SAndroid Build Coastguard Worker
20*6236dae4SAndroid Build Coastguard WorkerUse the specified SOCKS4a proxy. If the port number is not specified, it is
21*6236dae4SAndroid Build Coastguard Workerassumed at port 1080. This asks the proxy to resolve the hostname.
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerTo specify proxy on a Unix domain socket, use localhost for host, e.g.
24*6236dae4SAndroid Build Coastguard Worker`socks4a://localhost/path/to/socket.sock`
25*6236dae4SAndroid Build Coastguard Worker
26*6236dae4SAndroid Build Coastguard WorkerThis option overrides any previous use of --proxy, as they are mutually
27*6236dae4SAndroid Build Coastguard Workerexclusive.
28*6236dae4SAndroid Build Coastguard Worker
29*6236dae4SAndroid Build Coastguard WorkerThis option is superfluous since you can specify a socks4a proxy with --proxy
30*6236dae4SAndroid Build Coastguard Workerusing a socks4a:// protocol prefix. (Added in 7.21.7)
31*6236dae4SAndroid Build Coastguard Worker
32*6236dae4SAndroid Build Coastguard Worker--preproxy can be used to specify a SOCKS proxy at the same time --proxy is
33*6236dae4SAndroid Build Coastguard Workerused with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
34*6236dae4SAndroid Build Coastguard Workerconnects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
35*6236dae4SAndroid Build Coastguard WorkerHTTPS proxy.
36