DragonFly On-Line Manual Pages

Search: Section:  

CURLINFO_APPCONNECT_TIME_T(curl_easy_getinfo optiCURLINFO_APPCONNECT_TIME_T(3)


NAME

       CURLINFO_APPCONNECT_TIME_T  -  get the time until the SSL/SSH handshake
       is completed


SYNOPSIS

       #include <curl/curl.h>

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


DESCRIPTION

       Pass a pointer to a curl_off_t to receive the time, in microseconds, it
       took from the start until the SSL/SSH connect/handshake to  the	remote
       host  was  completed.   This  time  is  most  often  very  near	to the
       CURLINFO_PRETRANSFER_TIME_T(3) time, except  for  cases	such  as  HTTP
       pipelining  where  the  pretransfer time can be delayed due to waits in
       line for the pipeline and more.

       See also the TIMES overview in the curl_easy_getinfo(3) man page.


PROTOCOLS

       All


EXAMPLE

       curl = curl_easy_init();
       if(curl) {
	 curl_off_t connect;
	 curl_easy_setopt(curl, CURLOPT_URL, url);
	 res = curl_easy_perform(curl);
	 if(CURLE_OK == res) {
	   res = curl_easy_getinfo(curl, CURLINFO_APPCONNECT_TIME_T, &connect);
	   if(CURLE_OK == res) {
	     printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", connect / 1000000,
		    (long)(connect % 1000000));
	   }
	 }
	 /* always cleanup */
	 curl_easy_cleanup(curl);
       }


AVAILABILITY

       Added in 7.61.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), CURLINFO_APPCONNECT_TIME(3)

libcurl 7.63.0			 May 17, 2018	 CURLINFO_APPCONNECT_TIME_T(3)

Search: Section: