1 c: Copyright (C) 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 is 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 is used first. 23 24 The provided address set by this option is used even if --ipv4 or --ipv6 is 25 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 only makes sense for long running 29 parallel transfers with a lot of files. In such cases, if this option is used 30 curl tries to resolve the host as it normally would once the timeout has 31 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. 42