CURLOPT_CONNECTTIMEOUT - timeout for the connect phase
#include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT, long timeout);
CURLOPT_CONNECTTIMEOUT(3) curl_easy_setopt options CURLOPT_CONNECTTIMEOUT(3)
NAME
CURLOPT_CONNECTTIMEOUT - timeout for the connect phase
SYNOPSIS
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECTTIMEOUT, long timeout);
DESCRIPTION
Pass a long. It should contain the maximum time in seconds that you
allow the connection phase to the server to take. This only limits the
connection phase, it has no impact once it has connected. Set to zero
to switch to the default built-in connection timeout - 300 seconds. See
also the CURLOPT_TIMEOUT(3) option.
In unix-like systems, this might cause signals to be used unless CUR-
LOPT_NOSIGNAL(3) is set.
If both CURLOPT_CONNECTTIMEOUT(3) and CURLOPT_CONNECTTIMEOUT_MS(3) are
set, the value set last will be used.
DEFAULT
300
PROTOCOLS
All
EXAMPLE
CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
/* complete connection within 10 seconds */
curl_easy_setopt(curl, CURLOPT_CONNECTTIMEOUT, 10L);
curl_easy_perform(curl);
}
AVAILABILITY
Always
RETURN VALUE
Returns CURLE_OK. Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a nega-
tive value or a value that when converted to milliseconds is too large.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | web/curl |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
CURLOPT_CONNECTTIMEOUT_MS(3), CURLOPT_TIMEOUT(3), CUR-
LOPT_LOW_SPEED_LIMIT(3),
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://curl.se/down-
load/curl-7.83.1.tar.bz2.
Further information about this software can be found on the open source
community website at http://curl.haxx.se/.
libcurl 7.83.1 November 26, 2021 CURLOPT_CONNECTTIMEOUT(3)