resolve.d 1.6 KB

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