CURLOPT_RESOLVE.md: mention hostname can be wildcard ('*')

Closes #13983
This commit is contained in:
Daniel Stenberg 2024-06-22 22:50:15 +02:00
parent bd8e45c6c5
commit b84699bf4f
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2

View File

@ -45,13 +45,17 @@ numerical IP addresses. If you specify multiple IP addresses they need to be
separated by comma. If libcurl is built to support IPv6, each of the ADDRESS
entries can of course be either IPv4 or IPv6 style addressing.
Specify the host as a single ampersand (`*`) to match all names. This wildcard
is resolved last so any resolve with a specific host and port number is given
priority.
This option effectively populates the DNS cache with entries for the host+port
pair so redirects and everything that operations against the HOST+PORT instead
use your provided ADDRESS.
The optional leading "+" specifies that the new entry should time-out. Entries
added without the leading plus character never times out whereas entries added
with "+HOST:..." times out just like ordinary DNS cache entries.
The optional leading plus (`+`) specifies that the new entry should timeout.
Entries added without the leading plus character never times out whereas
entries added with `+HOST:...` times out just like ordinary DNS cache entries.
If the DNS cache already has an entry for the given host+port pair, the new
entry overrides the former one.
@ -62,7 +66,7 @@ setting of CURLOPT_IPRESOLVE(3) to a different IP version.
To remove names from the DNS cache again, to stop providing these fake
resolves, include a string in the linked list that uses the format
~~~c
~~~
-HOST:PORT
~~~