mirror of
https://github.com/curl/curl.git
synced 2026-08-26 05:13:31 +03:00
e3fe020089
Remove the PROTOCOLS section from the source files completely and instead generate them based on the header data in the curldown files. It also generates TLS backend information for options marked for TLS as protocol. Closes #13175
69 lines
1.4 KiB
Markdown
69 lines
1.4 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_TIMEVALUE_LARGE
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLINFO_FILETIME (3)
|
|
- CURLOPT_TIMECONDITION (3)
|
|
- CURLOPT_TIMEVALUE (3)
|
|
Protocol:
|
|
- HTTP
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_TIMEVALUE_LARGE - time value for conditional
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#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 is 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
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
curl_easy_setopt(curl, CURLOPT_URL, "https://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
|