113498266Sopenharmony_ci--- 213498266Sopenharmony_cic: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 313498266Sopenharmony_ciSPDX-License-Identifier: curl 413498266Sopenharmony_ciLong: resolve 513498266Sopenharmony_ciArg: <[+]host:port:addr[,addr]...> 613498266Sopenharmony_ciHelp: Resolve the host+port to this address 713498266Sopenharmony_ciAdded: 7.21.3 813498266Sopenharmony_ciCategory: connection dns 913498266Sopenharmony_ciMulti: append 1013498266Sopenharmony_ciSee-also: 1113498266Sopenharmony_ci - connect-to 1213498266Sopenharmony_ci - alt-svc 1313498266Sopenharmony_ciExample: 1413498266Sopenharmony_ci - --resolve example.com:443:127.0.0.1 $URL 1513498266Sopenharmony_ci--- 1613498266Sopenharmony_ci 1713498266Sopenharmony_ci# `--resolve` 1813498266Sopenharmony_ci 1913498266Sopenharmony_ciProvide a custom address for a specific host and port pair. Using this, you 2013498266Sopenharmony_cican make the curl requests(s) use a specified address and prevent the 2113498266Sopenharmony_ciotherwise normally resolved address to be used. Consider it a sort of 2213498266Sopenharmony_ci/etc/hosts alternative provided on the command line. The port number should be 2313498266Sopenharmony_cithe number used for the specific protocol the host is used for. It means 2413498266Sopenharmony_ciyou need several entries if you want to provide address for the same host but 2513498266Sopenharmony_cidifferent ports. 2613498266Sopenharmony_ci 2713498266Sopenharmony_ciBy specifying '*' as host you can tell curl to resolve any host and specific 2813498266Sopenharmony_ciport pair to the specified address. Wildcard is resolved last so any --resolve 2913498266Sopenharmony_ciwith a specific host and port is used first. 3013498266Sopenharmony_ci 3113498266Sopenharmony_ciThe provided address set by this option is used even if --ipv4 or --ipv6 is 3213498266Sopenharmony_ciset to make curl use another IP version. 3313498266Sopenharmony_ci 3413498266Sopenharmony_ciBy prefixing the host with a '+' you can make the entry time out after curl's 3513498266Sopenharmony_cidefault timeout (1 minute). Note that this only makes sense for long running 3613498266Sopenharmony_ciparallel transfers with a lot of files. In such cases, if this option is used 3713498266Sopenharmony_cicurl tries to resolve the host as it normally would once the timeout has 3813498266Sopenharmony_ciexpired. 3913498266Sopenharmony_ci 4013498266Sopenharmony_ciSupport for providing the IP address within [brackets] was added in 7.57.0. 4113498266Sopenharmony_ci 4213498266Sopenharmony_ciSupport for providing multiple IP addresses per entry was added in 7.59.0. 4313498266Sopenharmony_ci 4413498266Sopenharmony_ciSupport for resolving with wildcard was added in 7.64.0. 4513498266Sopenharmony_ci 4613498266Sopenharmony_ciSupport for the '+' prefix was was added in 7.75.0. 47