docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 06:18:43 +08:00
|
|
|
---
|
|
|
|
|
c: Copyright (C) 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
|
|
|
|
|
Category: connection
|
|
|
|
|
Multi: append
|
|
|
|
|
See-also:
|
|
|
|
|
- resolve
|
|
|
|
|
- header
|
|
|
|
|
Example:
|
|
|
|
|
- --connect-to example.com:443:example.net:8443 $URL
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# `--connect-to`
|
|
|
|
|
|
2024-03-12 17:34:58 +08:00
|
|
|
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.
|
docs/cmdline: change to .md for cmdline docs
- switch all invidual files documenting command line options into .md,
as the documentation is now markdown-looking.
- made the parser treat 4-space indents as quotes
- switch to building the curl.1 manpage using the "mainpage.idx" file,
which lists the files to include to generate it, instead of using the
previous page-footer/headers. Also, those files are now also .md
ones, using the same format. I gave them underscore prefixes to make
them sort separately:
_NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md,
_VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md,
_OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md,
_EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md
- updated test cases accordingly
Closes #12751
2024-01-21 06:18:43 +08:00
|
|
|
|
|
|
|
|
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`.
|
