gnutls_record_recv(3) — Linux manual pages

Linux manual pages	Section 3: Subroutines

Name

gnutls_record_recv — API function

Synopsis

#include <gnutls/gnutls.h>

`ssize_t gnutls_record_recv(`	gnutls_session_t `session`,
	void * `data`,
	size_t `data_size)`;

ARGUMENTS

gnutls_session_t session: is a gnutls_session_t structure.
void * data: the buffer that the data will be read into
size_t data_size: the number of requested bytes

DESCRIPTION

This function has the similar semantics with recv(). The only difference is that it accepts a GnuTLS session, and uses different error codes. In the special case that a server requests a renegotiation, the client may receive an error code of GNUTLS_E_REHANDSHAKE. This message may be simply ignored, replied with an alert GNUTLS_A_NO_RENEGOTIATION, or replied with a new handshake, depending on the client's will. If EINTR is returned by the internal push function (the default is recv()) then GNUTLS_E_INTERRUPTED will be returned. If GNUTLS_E_INTERRUPTED or GNUTLS_E_AGAIN is returned, you must call this function again to get the data. See also gnutls_record_get_direction(). A server may also receive GNUTLS_E_REHANDSHAKE when a client has initiated a handshake. In that case the server can only initiate a handshake or terminate the connection.

RETURNS

The number of bytes received and zero on EOF (for stream connections). A negative error code is returned in case of an error. The number of bytes received might be less than the requested data_size .

REPORTING BUGS

Report bugs to <bug-gnutls@gnu.org>.

General guidelines for reporting bugs: http://www.gnu.org/gethelp/

GnuTLS home page: http://www.gnu.org/software/gnutls/