Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_FILETIME(3)	   curl_easy_getinfo options	  CURLINFO_FILETIME(3)

NAME
       CURLINFO_FILETIME_T - get the remote time of the	retrieved document

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	    curl_easy_getinfo(CURL    *handle,	  CURLINFO_FILETIME_T,
       curl_off_t *timep);

DESCRIPTION
       Pass a pointer to a curl_off_t to receive the remote time  of  the  re-
       trieved	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 CURLOPT_FILETIME(3) option to	curl_easy_setopt(3) or
       you will	unconditionally	get a -1 back.

       This  option is an alternative to CURLINFO_FILETIME(3) to allow systems
       with 32 bit long	variables to extract dates outside of the 32bit	 time-
       stamp range.

PROTOCOLS
       HTTP(S),	FTP(S),	SFTP

EXAMPLE
       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);
       }

AVAILABILITY
       Added in	7.59.0

RETURN VALUE
       Returns	CURLE_OK  if the option	is supported, and CURLE_UNKNOWN_OPTION
       if not.

SEE ALSO
       curl_easy_getinfo(3), curl_easy_setopt(3),

libcurl	7.72.0		       January 25, 2018		  CURLINFO_FILETIME(3)

NAME | SYNOPSIS | DESCRIPTION | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLINFO_FILETIME_T&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help