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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_S...SE_TIMEOUT(3)  Library Functions Manual  CURLOPT_S...SE_TIMEOUT(3)

NAME
       CURLOPT_SERVER_RESPONSE_TIMEOUT	-  time	allowed	to wait	for server re-
       sponse

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_setopt(CURL *handle, CURLOPT_SERVER_RESPONSE_TIMEOUT,
				 long timeout);

DESCRIPTION
       Pass a long. It tells libcurl to	wait no	longer	than  timeout  seconds
       for  responses on sent commands.	If no response is received within this
       period, the connection is considered dead and the transfer fails.

       It is recommended that if used in conjunction with  CURLOPT_TIMEOUT(3),
       you set CURLOPT_SERVER_RESPONSE_TIMEOUT(3) to a value smaller than CUR-
       LOPT_TIMEOUT(3).

DEFAULT
       60 seconds

PROTOCOLS
       This functionality affects ftp, imap, pop3, scp,	sftp and smtp

EXAMPLE
       int main(void)
       {
	 CURL *curl = curl_easy_init();
	 if(curl) {
	   CURLcode res;
	   curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/slow.txt");
	   /* wait no more than	23 seconds */
	   curl_easy_setopt(curl, CURLOPT_SERVER_RESPONSE_TIMEOUT, 23L);
	   res = curl_easy_perform(curl);

	   curl_easy_cleanup(curl);
	 }
       }

HISTORY
       This option was formerly	known as CURLOPT_FTP_RESPONSE_TIMEOUT.

AVAILABILITY
       Added in	curl 7.20.0

RETURN VALUE
       curl_easy_setopt(3) returns a CURLcode indicating success or error.

       CURLE_OK	(0) means everything was OK, non-zero means an error occurred,
       see libcurl-errors(3).

SEE ALSO
       CURLOPT_CONNECTTIMEOUT(3),	CURLOPT_LOW_SPEED_LIMIT(3),	  CUR-
       LOPT_SERVER_RESPONSE_TIMEOUT_MS(3), CURLOPT_TIMEOUT(3)

libcurl				  2026-02-26	     CURLOPT_S...SE_TIMEOUT(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_SERVER_RESPONSE_TIMEOUT&sektion=3&manpath=FreeBSD+Ports+15.0.quarterly>

home | help