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

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_...ATA_SENT_T(3)  Library Functions Manual  CURLINFO_...ATA_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  ses-
       sion 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_...ATA_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