curl/docs/cmdline-opts/connect-to.md
Daniel Stenberg e7219c2bdc
cmdline-opts: language cleanups
Use imperative mood consistently for the first sentence describing an
option.

"Set this" instead "tell curl to set" or "this sets..."

Plus some extra cleanups and rephrasing.

Closes #13106
2024-03-12 15:42:33 +01:00

1012 B

c SPDX-License-Identifier Long Arg Help Added Category Multi See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl connect-to <HOST1:PORT1:HOST2:PORT2> Connect to host 7.49.0 connection append
resolve
header
--connect-to example.com:443:example.net:8443 $URL

--connect-to

For a request intended for the HOST1:PORT1 pair, connect to HOST2:PORT2 instead. This option is only used to establish the network connection. It does NOT affect the hostname/port number that is used for TLS/SSL (e.g. SNI, certificate verification) or for the application protocols.

HOST1 and PORT1 may be empty strings, meaning any host or any port number. HOST2 and PORT2 may also be empty strings, meaning use the request's original hostname and port number.

A hostname 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.