From 9c86097286e960ae52249482a1e4c9d4e2075028 Mon Sep 17 00:00:00 2001 From: Dan Fandrich Date: Tue, 28 Oct 2008 23:48:05 +0000 Subject: [PATCH] Mention more restrictions on timeouts when using signals --- docs/libcurl/curl_easy_setopt.3 | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3 index 6ebda874c..9d0ebe84f 100644 --- a/docs/libcurl/curl_easy_setopt.3 +++ b/docs/libcurl/curl_easy_setopt.3 @@ -21,7 +21,7 @@ .\" * $Id$ .\" ************************************************************************** .\" -.TH curl_easy_setopt 3 "16 Oct 2008" "libcurl 7.19.1" "libcurl Manual" +.TH curl_easy_setopt 3 "28 Oct 2008" "libcurl 7.19.1" "libcurl Manual" .SH NAME curl_easy_setopt \- set options for a curl easy handle .SH SYNOPSIS @@ -81,8 +81,10 @@ process. This option is mainly here to allow multi-threaded unix applications to still set/use all timeout options etc, without risking getting signals. (Added in 7.10) +If this option is set and libcurl has been built with the standard name +resolver, timeouts will not occur while the name resolve takes place. Consider building libcurl with ares support to enable asynchronous DNS -lookups. It enables nice timeouts for name resolves without signals. +lookups, which enables nice timeouts for name resolves without signals. .PP .SH CALLBACK OPTIONS .IP CURLOPT_WRITEFUNCTION @@ -1300,8 +1302,10 @@ In unix-like systems, this might cause signals to be used unless \fICURLOPT_NOSIGNAL\fP is set. .IP CURLOPT_TIMEOUT_MS Like \fICURLOPT_TIMEOUT\fP but takes number of milliseconds instead. If -libcurl is built to use the standard system name resolver, that part will -still use full-second resolution for timeouts. (Added in 7.16.2) +libcurl is built to use the standard system name resolver, that portion +of the transfer will still use full-second resolution for timeouts with +a minimum timeout allowed of one second. +(Added in 7.16.2) .IP CURLOPT_LOW_SPEED_LIMIT Pass a long as parameter. It contains the transfer speed in bytes per second that the transfer should be below during \fICURLOPT_LOW_SPEED_TIME\fP seconds @@ -1364,9 +1368,11 @@ timeouts). See also the \fICURLOPT_TIMEOUT\fP option. In unix-like systems, this might cause signals to be used unless \fICURLOPT_NOSIGNAL\fP is set. .IP CURLOPT_CONNECTTIMEOUT_MS -Like \fICURLOPT_CONNECTTIMEOUT\fP but takes number of milliseconds instead. If -libcurl is built to use the standard system name resolver, that part will -still use full-second resolution for timeouts. (Added in 7.16.2) +Like \fICURLOPT_CONNECTTIMEOUT\fP but takes the number of milliseconds +instead. If libcurl is built to use the standard system name resolver, +that portion of the connect will still use full-second resolution for +timeouts with a minimum timeout allowed of one second. +(Added in 7.16.2) .IP CURLOPT_IPRESOLVE Allows an application to select what kind of IP addresses to use when resolving host names. This is only interesting when using host names that