From: Andrey Sumin Date: Sun, 23 Mar 2014 14:19:17 +0000 (+0400) Subject: suggest to use libcurl with async dns resolver in httpclient docs X-Git-Tag: v4.0.0b1~89^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F1017%2Fhead;p=thirdparty%2Ftornado.git suggest to use libcurl with async dns resolver in httpclient docs --- diff --git a/tornado/httpclient.py b/tornado/httpclient.py index cf503c0d3..45e007e50 100644 --- a/tornado/httpclient.py +++ b/tornado/httpclient.py @@ -25,6 +25,11 @@ to switch to ``curl_httpclient`` for reasons such as the following: Note that if you are using ``curl_httpclient``, it is highly recommended that you use a recent version of ``libcurl`` and ``pycurl``. Currently the minimum supported version is 7.18.2, and the recommended version is 7.21.1 or newer. +It is highly recommended that your ``libcurl`` installation is built with +asynchronous DNS resolver (threaded or c-ares), otherwise you may encounter +various problems with request timeouts (for more information, see +http://curl.haxx.se/libcurl/c/curl_easy_setopt.html#CURLOPTCONNECTTIMEOUTMS +and comments in curl_httpclient.py). """ from __future__ import absolute_import, division, print_function, with_statement