diff options
| author | Anders Bakken <agbakken@gmail.com> | 2018-01-30 16:33:51 -0800 |
|---|---|---|
| committer | Jay Satiro <raysatiro@yahoo.com> | 2018-02-20 17:51:43 -0500 |
| commit | 2427d94c6d088b13ad971bb3cee5b7de42b37d24 (patch) | |
| tree | bbec8183cff0f20d8bd214abdcab5b66f1737669 /docs/cmdline-opts | |
| parent | 73050fb6ae3c58b6e5d085e8463d94b79dbf2737 (diff) | |
url: Add option CURLOPT_HAPPY_EYEBALLS_TIMEOUT
- Add new option CURLOPT_HAPPY_EYEBALLS_TIMEOUT to set libcurl's happy
eyeball timeout value.
- Add new optval macro CURL_HET_DEFAULT to represent the default happy
eyeballs timeout value (currently 200 ms).
- Add new tool option --happy-eyeballs-timeout-ms to expose
CURLOPT_HAPPY_EYEBALLS_TIMEOUT. The -ms suffix is used because the
other -timeout options in the tool expect seconds not milliseconds.
Closes https://github.com/curl/curl/pull/2260
Diffstat (limited to 'docs/cmdline-opts')
| -rw-r--r-- | docs/cmdline-opts/Makefile.inc | 4 | ||||
| -rw-r--r-- | docs/cmdline-opts/happy-eyeballs-timeout-ms.d | 17 |
2 files changed, 20 insertions, 1 deletions
diff --git a/docs/cmdline-opts/Makefile.inc b/docs/cmdline-opts/Makefile.inc index 9891f3717..778149ca3 100644 --- a/docs/cmdline-opts/Makefile.inc +++ b/docs/cmdline-opts/Makefile.inc @@ -12,7 +12,9 @@ DPAGES = abstract-unix-socket.d anyauth.d append.d basic.d cacert.d capath.d cer form.d form-string.d ftp-account.d ftp-alternative-to-user.d \ ftp-create-dirs.d ftp-method.d ftp-pasv.d ftp-port.d ftp-pret.d \ ftp-skip-pasv-ip.d ftp-ssl-ccc.d ftp-ssl-ccc-mode.d ftp-ssl-control.d \ - get.d globoff.d head.d header.d help.d hostpubmd5.d http1.0.d \ + get.d globoff.d \ + happy-eyeballs-timeout-ms.d \ + head.d header.d help.d hostpubmd5.d http1.0.d \ http1.1.d http2.d http2-prior-knowledge.d ignore-content-length.d \ include.d insecure.d interface.d ipv4.d ipv6.d junk-session-cookies.d \ keepalive-time.d key.d key-type.d krb.d libcurl.d limit-rate.d \ diff --git a/docs/cmdline-opts/happy-eyeballs-timeout-ms.d b/docs/cmdline-opts/happy-eyeballs-timeout-ms.d new file mode 100644 index 000000000..ec9a8c228 --- /dev/null +++ b/docs/cmdline-opts/happy-eyeballs-timeout-ms.d @@ -0,0 +1,17 @@ +Long: happy-eyeballs-timeout-ms +Arg: <milliseconds> +Help: How long to wait in milliseconds for IPv6 before trying IPv4 +Added: 7.59.0 +--- +Happy eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6 +addresses for dual-stack hosts, preferring IPv6 first for the number of +milliseconds. If the IPv6 address cannot be connected to within that time then +a connection attempt is made to the IPv4 address in parallel. The first +connection to be established is the one that is used. + +The range of suggested useful values is limited. Happy Eyeballs RFC 6555 says +"It is RECOMMENDED that connection attempts be paced 150-250 ms apart to +balance human factors against network load." libcurl currently defaults to +200 ms. Firefox and Chrome currently default to 300 ms. + +If this option is used several times, the last one will be used. |