gnutls_record_recv_packet — API function


#include <gnutls/gnutls.h>

ssize_t gnutls_record_recv_packet(gnutls_session_t session, gnutls_packet_t * packet);


gnutls_session_t session

is a gnutls_session_t type.

gnutls_packet_t * packet

the structure that will hold the packet data


This is a lower-level function than gnutls_record_recv() and allows to directly receive the whole decrypted packet. That avoids a memory copy, and is intended to be used by applications seeking high performance.

The received packet is accessed using gnutls_packet_get() and  must be deinitialized using gnutls_packet_deinit(). The returned packet will be NULL if the return value is zero (EOF).


The number of bytes received and zero on EOF (for stream connections).  A negative error code is returned in case of an error.  



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.9 gnutls