From 50d1b3379a818df00c6382d68e2e39977cc96cd6 Mon Sep 17 00:00:00 2001 From: Anders Bakken Date: Tue, 30 Jan 2018 16:33:51 -0800 Subject: CURLOPT_RESOLVE: Add support for multiple IP addresses per entry This enables users to preresolve but still take advantage of happy eyeballs and trying multiple addresses if some are not connecting. Ref: https://github.com/curl/curl/pull/2260 --- docs/cmdline-opts/resolve.d | 4 +++- docs/libcurl/opts/CURLOPT_RESOLVE.3 | 12 ++++++++---- 2 files changed, 11 insertions(+), 5 deletions(-) (limited to 'docs') diff --git a/docs/cmdline-opts/resolve.d b/docs/cmdline-opts/resolve.d index 91539b8e9..9e1457b5e 100644 --- a/docs/cmdline-opts/resolve.d +++ b/docs/cmdline-opts/resolve.d @@ -1,5 +1,5 @@ Long: resolve -Arg: +Arg: Help: Resolve the host+port to this address Added: 7.21.3 --- @@ -16,4 +16,6 @@ is set to make curl use another IP version. Support for providing the IP address within [brackets] was added in 7.57.0. +Support for providing multiple IP addresses per entry was added in 7.59.0. + This option can be used many times to add many host names to resolve. diff --git a/docs/libcurl/opts/CURLOPT_RESOLVE.3 b/docs/libcurl/opts/CURLOPT_RESOLVE.3 index c22f7b006..b4d79cf3b 100644 --- a/docs/libcurl/opts/CURLOPT_RESOLVE.3 +++ b/docs/libcurl/opts/CURLOPT_RESOLVE.3 @@ -37,10 +37,12 @@ list of \fBstruct curl_slist\fP structs properly filled in. Use to clean up an entire list. Each single name resolve string should be written using the format -HOST:PORT:ADDRESS where HOST is the name libcurl will try to resolve, PORT is -the port number of the service where libcurl wants to connect to the HOST and -ADDRESS is the numerical IP address. If libcurl is built to support IPv6, -ADDRESS can of course be either IPv4 or IPv6 style addressing. +HOST:PORT:ADDRESS[,ADDRESS]... where HOST is the name libcurl will try +to resolve, PORT is the port number of the service where libcurl wants +to connect to the HOST and ADDRESS is one or more 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. This option effectively pre-populates the DNS cache with entries for the host+port pair so redirects and everything that operations against the @@ -57,6 +59,8 @@ by including a string in the linked list that uses the format and port number must exactly match what was already added previously. Support for providing the ADDRESS within [brackets] was added in 7.57.0. + +Support for providing multiple IP addresses per entry was added in 7.59.0. .SH DEFAULT NULL .SH PROTOCOLS -- cgit v1.2.3