---
name: "CURLOPT_SERVER_RESPONSE_TIMEOUT_MS"
section: "3"
platform: "linux"
package: "curl"
version: "8.23.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS"
---

# CURLOPT\_SERVER\_RESPONSE\_TIMEOUT\_MS(3)

time allowed to wait for server response

## 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)](/CURLOPT_TIMEOUT/3.md)*, you set *[CURLOPT\_SERVER\_RESPONSE\_TIMEOUT\_MS(3)](/CURLOPT_SERVER_RESPONSE_TIMEOUT_MS/3.md)* to a value smaller than *[CURLOPT\_TIMEOUT(3)](/CURLOPT_TIMEOUT/3.md)*.

The maximum accepted value is 2147483648.

This is the millisecond version of *[CURLOPT\_SERVER\_RESPONSE\_TIMEOUT(3)](/CURLOPT_SERVER_RESPONSE_TIMEOUT/3.md)*.

## 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)](/curl_easy_setopt/3.md)* returns a CURLcode indicating success or error.

CURLE\_OK (0) means everything was OK, non-zero means an error occurred, see *[libcurl-errors(3)](/libcurl-errors/3.md)*.

## SEE ALSO

[**CURLOPT\_CONNECTTIMEOUT**(3)](/CURLOPT_CONNECTTIMEOUT/3.md), [**CURLOPT\_LOW\_SPEED\_LIMIT**(3)](/CURLOPT_LOW_SPEED_LIMIT/3.md), [**CURLOPT\_SERVER\_RESPONSE\_TIMEOUT**(3)](/CURLOPT_SERVER_RESPONSE_TIMEOUT/3.md), [**CURLOPT\_TIMEOUT**(3)](/CURLOPT_TIMEOUT/3.md)