connect-to.d 1.0 KB

123456789101112131415161718192021222324
  1. c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
  2. SPDX-License-Identifier: curl
  3. Long: connect-to
  4. Arg: <HOST1:PORT1:HOST2:PORT2>
  5. Help: Connect to host
  6. Added: 7.49.0
  7. See-also: resolve header
  8. Category: connection
  9. Example: --connect-to example.com:443:example.net:8443 $URL
  10. Multi: append
  11. ---
  12. For a request to the given HOST1:PORT1 pair, connect to HOST2:PORT2 instead.
  13. This option is suitable to direct requests at a specific server, e.g. at a
  14. specific cluster node in a cluster of servers. This option is only used to
  15. establish the network connection. It does NOT affect the hostname/port that is
  16. used for TLS/SSL (e.g. SNI, certificate verification) or for the application
  17. protocols. "HOST1" and "PORT1" may be the empty string, meaning "any
  18. host/port". "HOST2" and "PORT2" may also be the empty string, meaning "use the
  19. request's original host/port".
  20. A "host" specified to this option is compared as a string, so it needs to
  21. match the name used in request URL. It can be either numerical such as
  22. "127.0.0.1" or the full host name such as "example.org".