CURLOPT_SERVER_RESPONSE_TIMEOUT_MS(3) Library Functions Manual
NAME
CURLOPT_SERVER_RESPONSE_TIMEOUT_MS - time allowed to wait for server
response
SYNOPSIS
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SERVER_RESPONSE_TIMEOUT_MS,
long timeout);
DESCRIPTION
Pass a long. It tells libcurl to wait no longer than timeout
milliseconds 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_MS(3) to a value smaller than
CURLOPT_TIMEOUT(3).
The maximum accepted value is 2147483648.
This is the millisecond version of CURLOPT_SERVER_RESPONSE_TIMEOUT(3).
DEFAULT
60000 milliseconds
PROTOCOLS
This functionality affects ftp, imap, pop3, scp, sftp and smtp
EXAMPLE
int main(void)
{
CURL *curl = curl_easy_init();
if(curl) {
CURLcode result;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/slow.txt");
/* wait no more than 237 milliseconds */
curl_easy_setopt(curl, CURLOPT_SERVER_RESPONSE_TIMEOUT_MS, 237L);
result = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
}
AVAILABILITY
Added in curl 8.6.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),
CURLOPT_SERVER_RESPONSE_TIMEOUT(3), CURLOPT_TIMEOUT(3)
libcurl 2026-03-23
CURLOPT_SERVER_RESPONSE_TIMEOUT_MS(3)
curl 8.19.0 - Generated Tue Mar 31 07:23:04 CDT 2026