Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_record_recv(3)		    gnutls		 gnutls_record_recv(3)

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

       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  differ-
       ence  is	 that  it  accepts  a GnuTLS session, and uses different error
       codes.  In the special case that	the peer requests a renegotiation, the
       caller will receive an error code of GNUTLS_E_REHANDSHAKE.  In case  of
       a  client,  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. A	server receiving this error code can only ini-
       tiate a new handshake or	terminate the session.

       If EINTR	is returned by the internal  pull  function  (the  default  is
       recv()) then GNUTLS_E_INTERRUPTED will be returned.  If GNUTLS_E_INTER-
       RUPTED or GNUTLS_E_AGAIN	is returned, you must call this	function again
       to get the data.	 See also gnutls_record_get_direction().

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 <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

COPYRIGHT
       Copyright (C) 2001-2023 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  no-
       tice and	this notice are	preserved.

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

       https://www.gnutls.org/manual/

gnutls				     3.8.9		 gnutls_record_recv(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_record_recv&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help