DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_TIMEVALUE(3)




CURLOPT_TIMEVALUE(3)curl_easy_setopt options CURLOPT_TIMEVALUE(3)


NAME

     CURLOPT_TIMEVALUE - set time value for conditional


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL  *handle,  CURLOPT_TIMEVALUE,
     long val);


DESCRIPTION

     Pass a long val  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
     CURLOPT_TIMECONDITION(3).


DEFAULT

     0


PROTOCOLS

     HTTP, FTP, RTSP, and FILE


EXAMPLE

     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, 1577833200L);

       /* If-Modified-Since the above time stamp */
       curl_easy_setopt(curl, CURLOPT_TIMECONDITION, CURL_TIMECOND_IFMODSINCE);

       /* Perform the request */
       curl_easy_perform(curl);
     }


AVAILABILITY

     Always


RETURN VALUE

     Returns CURLE_OK


SEE ALSO

     CURLOPT_TIMECONDITION(3),

libcurl 7.58.0     Last change: April 03, 2016                  1


Man(1) output converted with man2html