| 1 |
Long: happy-eyeballs-timeout-ms |
| 2 |
Arg: <milliseconds> |
| 3 |
Help: How long to wait in milliseconds for IPv6 before trying IPv4 |
| 4 |
Added: 7.59.0 |
| 5 |
--- |
| 6 |
Happy eyeballs is an algorithm that attempts to connect to both IPv4 and IPv6 |
| 7 |
addresses for dual-stack hosts, preferring IPv6 first for the number of |
| 8 |
milliseconds. If the IPv6 address cannot be connected to within that time then |
| 9 |
a connection attempt is made to the IPv4 address in parallel. The first |
| 10 |
connection to be established is the one that is used. |
| 11 |
|
| 12 |
The range of suggested useful values is limited. Happy Eyeballs RFC 6555 says |
| 13 |
"It is RECOMMENDED that connection attempts be paced 150-250 ms apart to |
| 14 |
balance human factors against network load." libcurl currently defaults to |
| 15 |
200 ms. Firefox and Chrome currently default to 300 ms. |
| 16 |
|
| 17 |
If this option is used several times, the last one will be used. |