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 - get the remote time of the retrieved	document

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	  curl_easy_getinfo(CURL   *handle,   CURLINFO_FILETIME,  long
       *timep);

DESCRIPTION
       Pass a pointer to a long	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.

       Note  that  you must tell the server 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.

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) {
	   res = curl_easy_getinfo(curl, CURLINFO_FILETIME, &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.5

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	5.5.5			April 03, 2017		  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&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help