xref: /curl/docs/cmdline-opts/socks4a.md (revision f81f351b)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: socks4a
5Arg: <host[:port]>
6Help: SOCKS4a proxy on given host + port
7Added: 7.18.0
8Category: proxy
9Multi: single
10See-also:
11  - socks4
12  - socks5
13  - socks5-hostname
14Example:
15  - --socks4a hostname:4096 $URL
16---
17
18# `--socks4a`
19
20Use the specified SOCKS4a proxy. If the port number is not specified, it is
21assumed at port 1080. This asks the proxy to resolve the hostname.
22
23To specify proxy on a Unix domain socket, use localhost for host, e.g.
24`socks4a://localhost/path/to/socket.sock`
25
26This option overrides any previous use of --proxy, as they are mutually
27exclusive.
28
29This option is superfluous since you can specify a socks4a proxy with --proxy
30using a socks4a:// protocol prefix. (Added in 7.21.7)
31
32--preproxy can be used to specify a SOCKS proxy at the same time --proxy is
33used with an HTTP/HTTPS proxy (added in 7.52.0). In such a case, curl first
34connects to the SOCKS proxy and then connects (through SOCKS) to the HTTP or
35HTTPS proxy.
36