| xf.li | 6c8fc1e | 2023-08-12 00:11:09 -0700 | [diff] [blame] | 1 | c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al. |
| 2 | SPDX-License-Identifier: curl |
| 3 | Long: resolve |
| 4 | Arg: <[+]host:port:addr[,addr]...> |
| 5 | Help: Resolve the host+port to this address |
| 6 | Added: 7.21.3 |
| 7 | Category: connection dns |
| 8 | Example: --resolve example.com:443:127.0.0.1 $URL |
| 9 | See-also: connect-to alt-svc |
| 10 | Multi: append |
| 11 | --- |
| 12 | Provide a custom address for a specific host and port pair. Using this, you |
| 13 | can make the curl requests(s) use a specified address and prevent the |
| 14 | otherwise normally resolved address to be used. Consider it a sort of |
| 15 | /etc/hosts alternative provided on the command line. The port number should be |
| 16 | the number used for the specific protocol the host will be used for. It means |
| 17 | you need several entries if you want to provide address for the same host but |
| 18 | different ports. |
| 19 | |
| 20 | By specifying '*' as host you can tell curl to resolve any host and specific |
| 21 | port pair to the specified address. Wildcard is resolved last so any --resolve |
| 22 | with a specific host and port will be used first. |
| 23 | |
| 24 | The provided address set by this option will be used even if --ipv4 or --ipv6 |
| 25 | is set to make curl use another IP version. |
| 26 | |
| 27 | By prefixing the host with a '+' you can make the entry time out after curl's |
| 28 | default timeout (1 minute). Note that this will only make sense for long |
| 29 | running parallel transfers with a lot of files. In such cases, if this option |
| 30 | is used curl will try to resolve the host as it normally would once the |
| 31 | timeout has expired. |
| 32 | |
| 33 | Support for providing the IP address within [brackets] was added in 7.57.0. |
| 34 | |
| 35 | Support for providing multiple IP addresses per entry was added in 7.59.0. |
| 36 | |
| 37 | Support for resolving with wildcard was added in 7.64.0. |
| 38 | |
| 39 | Support for the '+' prefix was was added in 7.75.0. |
| 40 | |
| 41 | This option can be used many times to add many host names to resolve. |