luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-08-20 15:48:54 +02:00
Code Issues Packages Projects Releases Wiki Activity

gsocketclient: document Happy Eyeballs

Browse Source 
This isn't an API guarantee, but it's a potentially-surprising
behavior difference between the sync and async functions that is good
to know about, especially because our sync and async functions are
normally identical.
This commit is contained in:
Michael Catanzaro
2020-10-08 19:08:34 -05:00
parent d971ac7b21
commit 290d5722be
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
gio/gsocketclient.c
View File

@@ -1936,6 +1936,15 @@ g_socket_client_enumerator_callback (GObject *object,
* *
* This is the asynchronous version of g_socket_client_connect(). * This is the asynchronous version of g_socket_client_connect().
* *
* You may wish to prefer the asynchronous version even in synchronous
* command line programs because, since 2.60, it implements
* [RFC 8305](https://tools.ietf.org/html/rfc8305) "Happy Eyeballs"
* recommendations to work around long connection timeouts in networks
* where IPv6 is broken by performing an IPv4 connection simultaneously
* without waiting for IPv6 to time out, which is not supported by the
* synchronous call. (This is not an API guarantee, and may change in
* the future.)
*
* When the operation is finished @callback will be * When the operation is finished @callback will be
* called. You can then call g_socket_client_connect_finish() to get * called. You can then call g_socket_client_connect_finish() to get
* the result of the operation. * the result of the operation.