mirror of
https://github.com/curl/curl.git
synced 2025-01-06 13:44:52 +08: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
75 lines
1.5 KiB
Markdown
75 lines
1.5 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLOPT_FILETIME
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLINFO_FILETIME (3)
|
|
- curl_easy_getinfo (3)
|
|
Protocol:
|
|
- HTTP
|
|
- FTP
|
|
- SFTP
|
|
- FILE
|
|
- SMB
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLOPT_FILETIME - get the modification time of the remote resource
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#include <curl/curl.h>
|
|
|
|
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_FILETIME, long gettime);
|
|
~~~
|
|
|
|
# DESCRIPTION
|
|
|
|
Pass a long. If it is 1, libcurl attempts to get the modification time of the
|
|
remote document in this operation. This requires that the remote server sends
|
|
the time or replies to a time querying command. The curl_easy_getinfo(3)
|
|
function with the CURLINFO_FILETIME(3) argument can be used after a
|
|
transfer to extract the received time (if any).
|
|
|
|
# DEFAULT
|
|
|
|
0
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
int main(void)
|
|
{
|
|
CURL *curl = curl_easy_init();
|
|
if(curl) {
|
|
CURLcode res;
|
|
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/path.html");
|
|
/* Ask for filetime */
|
|
curl_easy_setopt(curl, CURLOPT_FILETIME, 1L);
|
|
res = curl_easy_perform(curl);
|
|
if(CURLE_OK == res) {
|
|
long filetime;
|
|
res = curl_easy_getinfo(curl, CURLINFO_FILETIME, &filetime);
|
|
if((CURLE_OK == res) && (filetime >= 0)) {
|
|
time_t file_time = (time_t)filetime;
|
|
printf("filetime: %s", ctime(&file_time));
|
|
}
|
|
}
|
|
/* always cleanup */
|
|
curl_easy_cleanup(curl);
|
|
}
|
|
}
|
|
~~~
|
|
|
|
# AVAILABILITY
|
|
|
|
Always, for SFTP since 7.49.0
|
|
|
|
# RETURN VALUE
|
|
|
|
Returns CURLE_OK
|