Blame doc/functions/gnutls_record_send_range

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {ssize_t} {gnutls_record_send_range} (gnutls_session_t @var{session}, const void * @var{data}, size_t @var{data_size}, const gnutls_range_st * @var{range})
Packit Service 4684c1
@var{session}: is a @code{gnutls_session_t}  type.
Packit Service 4684c1
Packit Service 4684c1
@var{data}: contains the data to send.
Packit Service 4684c1
Packit Service 4684c1
@var{data_size}: is the length of the data.
Packit Service 4684c1
Packit Service 4684c1
@var{range}: is the range of lengths in which the real data length must be hidden.
Packit Service 4684c1
Packit Service 4684c1
This function operates like @code{gnutls_record_send()}  but, while
Packit Service 4684c1
@code{gnutls_record_send()}  adds minimal padding to each TLS record,
Packit Service 4684c1
this function uses the TLS extra-padding feature to conceal the real
Packit Service 4684c1
data size within the range of lengths provided.
Packit Service 4684c1
Some TLS sessions do not support extra padding (e.g. stream ciphers in standard
Packit Service 4684c1
TLS or SSL3 sessions). To know whether the current session supports extra
Packit Service 4684c1
padding, and hence length hiding, use the @code{gnutls_record_can_use_length_hiding()} 
Packit Service 4684c1
function.
Packit Service 4684c1
Packit Service 4684c1
@strong{Note:} This function currently is limited to blocking sockets.
Packit Service 4684c1
Packit Service 4684c1
@strong{Returns:} The number of bytes sent (that is data_size in a successful invocation),
Packit Service 4684c1
or a negative error code.
Packit Service 4684c1
@end deftypefun