CURLOPT_LOW_SPEED_LIMIT(3)

1CURLOPT_LOW_SPEED_LIMIT(3) curl_easy_setopt options CURLOPT_LOW_SPEED_LIMIT(3)
2
3
4

NAME

6       CURLOPT_LOW_SPEED_LIMIT - low speed limit in bytes per second
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOW_SPEED_LIMIT,
12                                 long speedlimit);
13

DESCRIPTION

15       Pass  a  long  as  parameter. It contains the average transfer speed in
16       bytes per  second  that  the  transfer  should  be  below  during  CUR‐
17       LOPT_LOW_SPEED_TIME(3)  seconds  for  libcurl  to consider it to be too
18       slow and abort.
19

DEFAULT

21       0, disabled
22

PROTOCOLS

24       All
25

EXAMPLE

27       curl = curl_easy_init();
28       if(curl) {
29         curl_easy_setopt(curl, CURLOPT_URL, url);
30         /* abort if slower than 30 bytes/sec during 60 seconds */
31         curl_easy_setopt(curl, CURLOPT_LOW_SPEED_TIME, 60L);
32         curl_easy_setopt(curl, CURLOPT_LOW_SPEED_LIMIT, 30L);
33         res = curl_easy_perform(curl);
34         if(CURLE_OPERATION_TIMEDOUT == res) {
35           printf("Timeout!\n");
36         }
37         /* always cleanup */
38         curl_easy_cleanup(curl);
39       }
40

AVAILABILITY

42       Always
43

RETURN VALUE

45       Returns CURLE_OK
46