CURLOPT_SERVER_RESPONSE_TIMEOUT_MS(3) Introduction to Library Functions

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-01-08
CURLOPT_SERVER_RESPONSE_TIMEOUT_MS(3)