gnutls_record_recv_packet

Section: gnutls (3)
Updated: 3.7.1
Page Index

NAME

gnutls_record_recv_packet - API function

SYNOPSIS

#include <gnutls/gnutls.h>

ssize_t gnutls_record_recv_packet(gnutls_session_t session, gnutls_packet_t * packet);

ARGUMENTS

gnutls_session_t session: is a gnutls_session_t type.
gnutls_packet_t * packet: the structure that will hold the packet data

DESCRIPTION

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).

RETURNS

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

SINCE

3.3.5

REPORTING BUGS

Report bugs to <bugs@gnutls.org>.
Home page: https://www.gnutls.org

COPYRIGHT

Copyright © 2001- Free Software Foundation, Inc., and others.
Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.