| 1 |
|
| 2 |
|
| 3 |
|
| 4 |
|
| 5 |
@deftypefun {ssize_t} {gnutls_record_recv_early_data} (gnutls_session_t @var{session}, void * @var{data}, size_t @var{data_size}) |
| 6 |
@var{session}: is a @code{gnutls_session_t} type. |
| 7 |
|
| 8 |
@var{data}: the buffer that the data will be read into |
| 9 |
|
| 10 |
@var{data_size}: the number of requested bytes |
| 11 |
|
| 12 |
This function can be used by a server to retrieve data sent early |
| 13 |
in the handshake processes when resuming a session. This is used |
| 14 |
to implement a zero-roundtrip (0-RTT) mode. It has the same |
| 15 |
semantics as @code{gnutls_record_recv()} . |
| 16 |
|
| 17 |
This function can be called either in a handshake hook, or after |
| 18 |
the handshake is complete. |
| 19 |
|
| 20 |
@strong{Returns:} The number of bytes received and zero when early data |
| 21 |
reading is complete. A negative error code is returned in case of |
| 22 |
an error. If no early data is received during the handshake, this |
| 23 |
function returns @code{GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE} . The |
| 24 |
number of bytes received might be less than the requested |
| 25 |
@code{data_size} . |
| 26 |
|
| 27 |
@strong{Since:} 3.6.5 |
| 28 |
@end deftypefun |