Imported Upstream version 7.53.1
[platform/upstream/curl.git] / docs / cmdline-opts / connect-to.d
1 Long: connect-to
2 Arg: <HOST1:PORT1:HOST2:PORT2>
3 Help: Connect to host
4 Added: 7.49.0
5 See-also: resolve header
6 ---
7
8 For a request to the given HOST:PORT pair, connect to
9 CONNECT-TO-HOST:CONNECT-TO-PORT instead.  This option is suitable to direct
10 requests at a specific server, e.g. at a specific cluster node in a cluster of
11 servers.  This option is only used to establish the network connection. It
12 does NOT affect the hostname/port that is used for TLS/SSL (e.g. SNI,
13 certificate verification) or for the application protocols.  "host" and "port"
14 may be the empty string, meaning "any host/port".  "connect-to-host" and
15 "connect-to-port" may also be the empty string, meaning "use the request's
16 original host/port".
17
18 This option can be used many times to add many connect rules.