dwww Home | Manual pages | Find package

CURLINFO_E...DATA_SENT_T(3) Library Functions ManualCURLINFO_E...DATA_SENT_T(3)

NAME
       CURLINFO_EARLYDATA_SENT_T  -  get  the 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 res;
           curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

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

           if(!res) {
             curl_off_t amount;
             res = curl_easy_getinfo(curl, CURLINFO_EARLYDATA_SENT_T, &amount);
             if(!res) {
               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-07-12       CURLINFO_E...DATA_SENT_T(3)

Generated by dwww version 1.16 on Sat Oct 3 11:22:47 CEST 2026.