CURLOPT_TIMEVALUE_LARGE(3)

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

NAME

6       CURLOPT_TIMEVALUE_LARGE - set 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
21       option 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, "http://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