Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 al-
       low  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, "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 nega-
       tive value or a value that when converted to milliseconds is too	large.

SEE ALSO
       CURLOPT_CONNECTTIMEOUT_MS(3),	      CURLOPT_TIMEOUT(3),	  CUR-
       LOPT_LOW_SPEED_LIMIT(3),

libcurl	7.72.0		       October 03, 2017	     CURLOPT_CONNECTTIMEOUT(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_CONNECTTIMEOUT&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help