]> git.ipfire.org Git - thirdparty/curl.git/commitdiff
CURLOPT_RESOLVE.md: mention hostname can be wildcard ('*')
authorDaniel Stenberg <daniel@haxx.se>
Sat, 22 Jun 2024 20:50:15 +0000 (22:50 +0200)
committerDaniel Stenberg <daniel@haxx.se>
Sun, 23 Jun 2024 08:29:22 +0000 (10:29 +0200)
Closes #13983

docs/libcurl/opts/CURLOPT_RESOLVE.md

index 800e3a82dba6bcc259a00afd83d380853c5c128b..ff1b50bb46eb98e8455659df9c032099f7590686 100644 (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
 ~~~