"Fossies" - the Fresh Open Source Software Archive

Member "curl-7.66.0/docs/libcurl/opts/CURLOPT_TIMEVALUE_LARGE.3" (11 Sep 2019, 2408 Bytes) of package /linux/www/curl-7.66.0.tar.xz:


Caution: As a special service "Fossies" has tried to format the requested manual source page into HTML format but links to other man pages may be missing or even erroneous. Alternatively you can here view or download the uninterpreted manual source code. A member file download can also be achieved by clicking within a package contents listing on the according byte size field. See also the latest Fossies "Diffs" side-by-side code changes report for "CURLOPT_TIMEVALUE_LARGE.3": 7.65.3_vs_7.66.0.

CURLOPT_TIMEVALUE_LARGE

NAME
SYNOPSIS
DESCRIPTION
DEFAULT
PROTOCOLS
EXAMPLE
AVAILABILITY
RETURN VALUE
SEE ALSO

NAME

CURLOPT_TIMEVALUE_LARGE − set time value for conditional

SYNOPSIS

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE_LARGE, curl_off_t val);

DESCRIPTION

Pass a curl_off_t val as parameter. This should be the time counted as seconds since 1 Jan 1970, and the time will be used in a condition as specified with CURLOPT_TIMECONDITION(3).

The difference between this option and CURLOPT_TIMEVALUE(3) is the type of the argument. On systems where ’long’ is only 32 bit wide, this option has to be used to set dates beyond the year 2038.

DEFAULT

0

PROTOCOLS

HTTP, FTP, RTSP, and FILE

EXAMPLE

CURL *curl = curl_easy_init();
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");

/* January 1, 2020 is 1577833200 */
curl_easy_setopt(curl, CURLOPT_TIMEVALUE_LARGE, (curl_off_t)1577833200);

/* If-Modified-Since the above time stamp */
curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);

/* Perform the request */
curl_easy_perform(curl);
}

AVAILABILITY

Added in 7.59.0.

RETURN VALUE

Returns CURLE_OK

SEE ALSO

CURLOPT_TIMECONDITION(3), CURLOPT_TIMEVALUE_LARGE(3),