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

FreeBSD Manual Pages

  
 
  

home | help 
CURLINFO_E...DATA_SENT_T(3) Library Functions Manual CURLINFO_E...DATA_SENT_T(3)

NAME
     CURLINFO_EARLYDATA_SENT_T - number of bytes sent as TLS early data

SYNOPSIS
     #include <curl/curl.h>

     CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_EARLYDATA_SENT_T,
				curl_off_t *amount);

DESCRIPTION
     Pass  a  pointer to an curl_off_t to receive the total amount of bytes that
     were sent to the server as TLSv1.3 early data. When no TLS  early	data  is
     used, this reports 0.

     TLS  early  data is only attempted when CURLSSLOPT_EARLYDATA is set for the
     transfer. In addition, it is only used by libcurl when a TLS session exists
     that announces support.

     The amount is negative when the sent data was rejected by the  server.  TLS
     allows a server that announces support for early data to reject any attempt
     to  use it at its own discretion. When for example 127 bytes had been sent,
     but were rejected, it reports -127 as the amount "sent".

PROTOCOLS
     This functionality affects all TLS based  protocols:  HTTPS,  FTPS,  IMAPS,
     POP3S, SMTPS etc.

     This option works only with the following TLS backends: GnuTLS

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

	 /* Perform the request */
	 result = curl_easy_perform(curl);

	 if(result == CURLE_OK) {
	   curl_off_t amount;
	   result = curl_easy_getinfo(curl, CURLINFO_EARLYDATA_SENT_T, &amount);
	   if(result == CURLE_OK) {
	     printf("TLS earlydata: %" CURL_FORMAT_CURL_OFF_T " bytes\n", amount);
	   }
	 }
       }
     }

AVAILABILITY
     Added in curl 8.11.0

RETURN VALUE
     curl_easy_getinfo(3) returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3).

SEE ALSO
     curl_easy_getinfo(3), curl_easy_setopt(3)

libcurl 			   2026-06-11	     CURLINFO_E...DATA_SENT_T(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLINFO_EARLYDATA_SENT_T&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help