CURLOPT_TIMEVALUE_LARGE(3)

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

NAME

6       CURLOPT_TIMEVALUE_LARGE - time value for conditional
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE_LARGE,
12                                 curl_off_t val);
13

DESCRIPTION

15       Pass  a curl_off_t val as parameter. This should be the time counted as
16       seconds since 1 Jan 1970, and the time will be used in a  condition  as
17       specified with CURLOPT_TIMECONDITION(3).
18
19       The difference between this option and CURLOPT_TIMEVALUE(3) is the type
20       of the argument. On systems where 'long' is only 32 bit wide, this  op‐
21       tion has to be used to set dates beyond the year 2038.
22

DEFAULT

24       0
25

PROTOCOLS

27       HTTP, FTP, RTSP, and FILE
28

EXAMPLE

30       CURL *curl = curl_easy_init();
31       if(curl) {
32         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
33
34         /* January 1, 2020 is 1577833200 */
35         curl_easy_setopt(curl, CURLOPT_TIMEVALUE_LARGE, (curl_off_t)1577833200);
36
37         /* If-Modified-Since the above time stamp */
38         curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);
39
40         /* Perform the request */
41         curl_easy_perform(curl);
42       }
43

AVAILABILITY

45       Added in 7.59.0.
46

RETURN VALUE

48       Returns CURLE_OK
49