CURLOPT_FTP_RESPONSE_TIMEOUT(3)

1CURLOPT_FTP_RESPONSE_TIMEOUTc(u3r)l_easy_setopt optiCoUnRsLOPT_FTP_RESPONSE_TIMEOUT(3)
2
3
4

NAME

6       CURLOPT_FTP_RESPONSE_TIMEOUT - time allowed to wait for FTP response
7

SYNOPSIS

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

DESCRIPTION

15       Pass  a  long.   Causes libcurl to set a timeout period (in seconds) on
16       the amount of time that the server is allowed to take in order to  send
17       a response message for a command before the session is considered dead.
18       While libcurl is waiting for a  response,  this  value  overrides  CUR‐
19       LOPT_TIMEOUT(3).  It  is  recommended  that if used in conjunction with
20       CURLOPT_TIMEOUT(3), you set CURLOPT_FTP_RESPONSE_TIMEOUT(3) to a  value
21       smaller than CURLOPT_TIMEOUT(3).
22

DEFAULT

24       None
25

PROTOCOLS

27       FTP
28

EXAMPLE

30       CURL *curl = curl_easy_init();
31       if(curl) {
32         curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/slow.txt");
33         /* wait no more than 23 seconds */
34         curl_easy_setopt(curl, CURLOPT_FTP_RESPONSE_TIMEOUT, 23L);
35         ret = curl_easy_perform(curl);
36
37         curl_easy_cleanup(curl);
38       }
39

AVAILABILITY

41       Added in 7.10.8
42

RETURN VALUE

44       Returns  CURLE_OK if FTP is supported, and CURLE_UNKNOWN_OPTION if not.
45       Returns CURLE_BAD_FUNCTION_ARGUMENT if set to a  negative  value  or  a
46       value that when converted to milliseconds is too large.
47