gnutls_record_get_state man page

gnutls_record_get_state — API function


#include <gnutls/gnutls.h>

int gnutls_record_get_state(gnutls_session_t session, unsigned read, gnutls_datum_t * mac_key, gnutls_datum_t * IV, gnutls_datum_t * cipher_key, unsigned char seq_number[8]);


gnutls_session_t session

is a gnutls_session_t type

unsigned read

if non-zero the read parameters are returned, otherwise the write

gnutls_datum_t * mac_key

the key used for MAC (if a MAC is used)

gnutls_datum_t * IV

the initialization vector or nonce used

gnutls_datum_t * cipher_key

the cipher key

unsigned char seq_number[8]

-- undescribed --


This function will return the parameters of the current record state. These are only useful to be provided to an external off-loading device or subsystem.

In that case, to sync the state you must call gnutls_record_set_state().


GNUTLS_E_SUCCESS on success, or an error code.

Since 3.4.0

Reporting Bugs

Report bugs to <>.
Home page:

See Also

The full documentation for gnutls is maintained as a Texinfo manual. If the /usr/share/doc/gnutls/ directory does not contain the HTML form visit


3.6.2 gnutls