diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2009-11-24 07:40:43 +0000 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2009-11-24 07:40:43 +0000 |
| commit | 88fe6557e9359b74744bb5300e5283d12d48aeaf (patch) | |
| tree | 9b42f3f781f41096450a1934afd9aadd83fd0181 | |
| parent | 405e18571e7ea924f435fe9a45e53e04c33ba624 (diff) | |
| download | gnurl-88fe6557e9359b74744bb5300e5283d12d48aeaf.tar.gz gnurl-88fe6557e9359b74744bb5300e5283d12d48aeaf.tar.bz2 gnurl-88fe6557e9359b74744bb5300e5283d12d48aeaf.zip | |
refreshed
| -rw-r--r-- | lib/README.multi_socket | 31 |
1 files changed, 12 insertions, 19 deletions
diff --git a/lib/README.multi_socket b/lib/README.multi_socket index c8eabf64c..953209810 100644 --- a/lib/README.multi_socket +++ b/lib/README.multi_socket @@ -12,14 +12,14 @@ Implementation of the curl_multi_socket API any other transfers. (The previous API always had to scan through all the existing transfers.) - The idea is that curl_multi_socket() calls a given callback with information - about what socket to wait for what action on, and the callback only gets - called if the status of that socket has changed. + The idea is that curl_multi_socket_action() calls a given callback with + information about what socket to wait for what action on, and the callback + only gets called if the status of that socket has changed. In the API draft from before, we have a timeout argument on a per socket - basis and we also allowed curl_multi_socket() to pass in an 'easy handle' - instead of socket to allow libcurl to shortcut a lookup and work on the - affected easy handle right away. Both these turned out to be bad ideas. + basis and we also allowed curl_multi_socket_action() to pass in an 'easy + handle' instead of socket to allow libcurl to shortcut a lookup and work on + the affected easy handle right away. Both these turned out to be bad ideas. The timeout argument was removed from the socket callback since after much thinking I came to the conclusion that we really don't want to handle @@ -54,20 +54,13 @@ Implementation of the curl_multi_socket API included in the c-ares 1.3.1 release. We have done a test runs with up to 9000 connections (with a single active - one). The curl_multi_socket() invoke then takes less than 10 microseconds in - average (using the read-only-1-byte-at-a-time hack). We are now below the - 60 microseconds "per socket action" goal (the extra 50 is the time libevent - needs). + one). The curl_multi_socket_action() invoke then takes less than 10 + microseconds in average (using the read-only-1-byte-at-a-time hack). We are + now below the 60 microseconds "per socket action" goal (the extra 50 is the + time libevent needs). -Status Right Now +Documentation - The curl_multi_socket() API is implemented according to how it is - documented. We deem it ready to use. - - http://curl.haxx.se/libcurl/c/curl_multi_socket.html + http://curl.haxx.se/libcurl/c/curl_multi_socket_action.html http://curl.haxx.se/libcurl/c/curl_multi_timeout.html http://curl.haxx.se/libcurl/c/curl_multi_setopt.html - -What is Left for the curl_multi_socket API - - Real world usage! |