CURLOPT_CONNECTTIMEOUT(3)

CURLOPT_CONNECTTIMEOUT(3curl_easy_setopt optionCURLOPT_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 CURLOPT_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, "http://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  negative value or a value that when converted to mil-
     liseconds is too large.

SEE ALSO

     CURLOPT_CONNECTTIMEOUT_MS(3),            CURLOPT_TIMEOUT(3),
     CURLOPT_LOW_SPEED_LIMIT(3),

libcurl 7.58.0    Last change: October 03, 2017                 1