mirror of
https://github.com/curl/curl.git
synced 2025-02-05 14:30:10 +08:00
ef305de95c
The keyword specifies how option works when specified multiple times: - single: the last provided value replaces the earlier ones - append: it supports being provided multiple times - boolean: on/off values - mutex: flag-like option that disable anoter flag The 'gen.pl' script then outputs the proper and unified language for each option's multi-use behavior in the generated man page. The multi: header is requires in each .d file and will cause build error if missing or set to an unknown value. Closes #9759
25 lines
1.1 KiB
D
25 lines
1.1 KiB
D
c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Long: connect-to
|
|
Arg: <HOST1:PORT1:HOST2:PORT2>
|
|
Help: Connect to host
|
|
Added: 7.49.0
|
|
See-also: resolve header
|
|
Category: connection
|
|
Example: --connect-to example.com:443:example.net:8443 $URL
|
|
Multi: append
|
|
---
|
|
|
|
For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead.
|
|
This option is suitable to direct requests at a specific server, e.g. at a
|
|
specific cluster node in a cluster of servers. This option is only used to
|
|
establish the network connection. It does NOT affect the hostname/port that is
|
|
used for TLS/SSL (e.g. SNI, certificate verification) or for the application
|
|
protocols. "HOST1" and "PORT1" may be the empty string, meaning "any
|
|
host/port". "HOST2" and "PORT2" may also be the empty string, meaning "use the
|
|
request's original host/port".
|
|
|
|
A "host" specified to this option is compared as a string, so it needs to
|
|
match the name used in request URL. It can be either numerical such as
|
|
"127.0.0.1" or the full host name such as "example.org".
|