mirror of
https://github.com/curl/curl.git
synced 2024-12-15 06:40:09 +08:00
68784d73c3
The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654
20 lines
893 B
D
20 lines
893 B
D
Long: happy-eyeballs-timeout-ms
|
|
Arg: <milliseconds>
|
|
Help: Time for IPv6 before trying IPv4
|
|
Added: 7.59.0
|
|
Category: connection
|
|
Example: --happy-eyeballs-timeout-ms 500 $URL
|
|
---
|
|
Happy Eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6
|
|
addresses for dual-stack hosts, giving IPv6 a head-start of the specified
|
|
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.
|