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

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_PRETRANSFER_TIME_Tcurl_easy_getinfo optCURLINFO_PRETRANSFER_TIME_T(3)

NAME
       CURLINFO_PRETRANSFER_TIME_T  -  get  the	 time  until the file transfer
       start

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_getinfo(CURL	*handle,  CURLINFO_PRETRANSFER_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 file transfer is  just  about  to	begin.
       This  includes all pre-transfer commands	and negotiations that are spe-
       cific to	the particular protocol(s) involved. It	does not  involve  the
       sending of the protocol-	specific request that triggers a transfer.

       When  a	redirect  is followed, the time	from each request is added to-
       gether.

       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 pretransfer;
	 curl_easy_setopt(curl,	CURLOPT_URL, url);
	 res = curl_easy_perform(curl);
	 if(CURLE_OK ==	res) {
	   res = curl_easy_getinfo(curl, CURLINFO_PRETRANSFER_TIME_T, &pretransfer);
	   if(CURLE_OK == res) {
	     printf("Time: %" CURL_FORMAT_CURL_OFF_T ".%06ld", pretransfer / 1000000,
		    (long)(pretransfer % 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_PRETRANSFER_TIME(3)

libcurl	7.72.0			August 26, 2019	CURLINFO_PRETRANSFER_TIME_T(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_PRETRANSFER_TIME_T&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help