| 1234567891011121314151617181920212223242526272829303132333435363738394041 |
- c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
- SPDX-License-Identifier: curl
- Long: resolve
- Arg: <[+]host:port:addr[,addr]...>
- Help: Resolve the host+port to this address
- Added: 7.21.3
- Category: connection dns
- Example: --resolve example.com:443:127.0.0.1 $URL
- See-also: connect-to alt-svc
- Multi: append
- ---
- Provide a custom address for a specific host and port pair. Using this, you
- can make the curl requests(s) use a specified address and prevent the
- otherwise normally resolved address to be used. Consider it a sort of
- /etc/hosts alternative provided on the command line. The port number should be
- the number used for the specific protocol the host is used for. It means
- you need several entries if you want to provide address for the same host but
- different ports.
- By specifying '*' as host you can tell curl to resolve any host and specific
- port pair to the specified address. Wildcard is resolved last so any --resolve
- with a specific host and port is used first.
- The provided address set by this option is used even if --ipv4 or --ipv6 is
- set to make curl use another IP version.
- By prefixing the host with a '+' you can make the entry time out after curl's
- default timeout (1 minute). Note that this only makes sense for long running
- parallel transfers with a lot of files. In such cases, if this option is used
- curl tries to resolve the host as it normally would once the timeout has
- expired.
- Support for providing the IP address within [brackets] was added in 7.57.0.
- Support for providing multiple IP addresses per entry was added in 7.59.0.
- Support for resolving with wildcard was added in 7.64.0.
- Support for the '+' prefix was was added in 7.75.0.
- This option can be used many times to add many host names to resolve.
|
