Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
14 changed files
with
193 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,71 @@ | ||
.\" ************************************************************************** | ||
.\" * _ _ ____ _ | ||
.\" * Project ___| | | | _ \| | | ||
.\" * / __| | | | |_) | | | ||
.\" * | (__| |_| | _ <| |___ | ||
.\" * \___|\___/|_| \_\_____| | ||
.\" * | ||
.\" * Copyright (C) 1998 - 2018, Daniel Stenberg, <daniel@haxx.se>, et al. | ||
.\" * | ||
.\" * This software is licensed as described in the file COPYING, which | ||
.\" * you should have received as part of this distribution. The terms | ||
.\" * are also available at https://curl.haxx.se/docs/copyright.html. | ||
.\" * | ||
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell | ||
.\" * copies of the Software, and permit persons to whom the Software is | ||
.\" * furnished to do so, under the terms of the COPYING file. | ||
.\" * | ||
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY | ||
.\" * KIND, either express or implied. | ||
.\" * | ||
.\" ************************************************************************** | ||
.\" | ||
.TH CURLINFO_FILETIME 3 "25 Jan 2018" "libcurl 7.59.0" "curl_easy_getinfo options" | ||
.SH NAME | ||
CURLINFO_FILETIME_T \- get the remote time of the retrieved document | ||
.SH SYNOPSIS | ||
#include <curl/curl.h> | ||
|
||
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_FILETIME_T, curl_off_t *timep); | ||
.SH DESCRIPTION | ||
Pass a pointer to a curl_off_t to receive the remote time of the retrieved | ||
document (in number of seconds since 1 jan 1970 in the GMT/UTC time zone). If | ||
you get -1, it can be because of many reasons (it might be unknown, the server | ||
might hide it or the server doesn't support the command that tells document | ||
time etc) and the time of the document is unknown. | ||
|
||
You must ask libcurl to collect this information before the transfer is made, | ||
by using the \fICURLOPT_FILETIME(3)\fP option to \fIcurl_easy_setopt(3)\fP or | ||
you will unconditionally get a -1 back. | ||
|
||
This option is an alternative to \fICURLINFO_FILETIME(3)\fP to allow systems | ||
with 32 bit long variables to extract dates outside of the 32bit timestamp | ||
range. | ||
.SH PROTOCOLS | ||
HTTP(S), FTP(S), SFTP | ||
.SH EXAMPLE | ||
.nf | ||
curl = curl_easy_init(); | ||
if(curl) { | ||
curl_easy_setopt(curl, CURLOPT_URL, url); | ||
/* Ask for filetime */ | ||
curl_easy_setopt(curl, CURLOPT_FILETIME, 1L); | ||
res = curl_easy_perform(curl); | ||
if(CURLE_OK == res) { | ||
curl_off_t filetime; | ||
res = curl_easy_getinfo(curl, CURLINFO_FILETIME_T, &filetime); | ||
if((CURLE_OK == res) && (filetime >= 0)) { | ||
time_t file_time = (time_t)filetime; | ||
printf("filetime %s: %s", filename, ctime(&file_time)); | ||
} | ||
} | ||
/* always cleanup */ | ||
curl_easy_cleanup(curl); | ||
} | ||
.fi | ||
.SH AVAILABILITY | ||
Added in 7.59.0 | ||
.SH RETURN VALUE | ||
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. | ||
.SH "SEE ALSO" | ||
.BR curl_easy_getinfo "(3), " curl_easy_setopt "(3), " |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,64 @@ | ||
.\" ************************************************************************** | ||
.\" * _ _ ____ _ | ||
.\" * Project ___| | | | _ \| | | ||
.\" * / __| | | | |_) | | | ||
.\" * | (__| |_| | _ <| |___ | ||
.\" * \___|\___/|_| \_\_____| | ||
.\" * | ||
.\" * Copyright (C) 1998 - 2018, Daniel Stenberg, <daniel@haxx.se>, et al. | ||
.\" * | ||
.\" * This software is licensed as described in the file COPYING, which | ||
.\" * you should have received as part of this distribution. The terms | ||
.\" * are also available at https://curl.haxx.se/docs/copyright.html. | ||
.\" * | ||
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell | ||
.\" * copies of the Software, and permit persons to whom the Software is | ||
.\" * furnished to do so, under the terms of the COPYING file. | ||
.\" * | ||
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY | ||
.\" * KIND, either express or implied. | ||
.\" * | ||
.\" ************************************************************************** | ||
.\" | ||
.TH CURLOPT_TIMEVALUE_LARGE 3 "25 Jan 2018" "libcurl 7.59.0" "curl_easy_setopt options" | ||
.SH NAME | ||
CURLOPT_TIMEVALUE_LARGE \- set time value for conditional | ||
.SH SYNOPSIS | ||
#include <curl/curl.h> | ||
|
||
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE_LARGE, curl_off_t val); | ||
.SH DESCRIPTION | ||
Pass a curl_off_t \fIval\fP 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 \fICURLOPT_TIMECONDITION(3)\fP. | ||
|
||
The difference between this option and \fICURLOPT_TIMEVALUE(3)\fP 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. | ||
.SH DEFAULT | ||
0 | ||
.SH PROTOCOLS | ||
HTTP, FTP, RTSP, and FILE | ||
.SH EXAMPLE | ||
.nf | ||
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); | ||
} | ||
.fi | ||
.SH AVAILABILITY | ||
Added in 7.59.0. | ||
.SH RETURN VALUE | ||
Returns CURLE_OK | ||
.SH "SEE ALSO" | ||
.BR CURLOPT_TIMECONDITION "(3), " | ||
.BR CURLOPT_TIMEVALUE_LARGE "(3), " |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters