1gnutls_record_recv(3)               gnutls               gnutls_record_recv(3)
2
3
4

NAME

6       gnutls_record_recv - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       ssize_t   gnutls_record_recv(gnutls_session_t  session,  void  *  data,
12       size_t data_size);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t structure.
17
18       void * data the buffer that the data will be read into
19
20       size_t data_size
21                   the number of requested bytes
22

DESCRIPTION

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

RETURNS

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

REPORTING BUGS

44       Report bugs to <bugs@gnutls.org>.
45       Home page: http://www.gnutls.org
46
47

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

SEE ALSO

55       The full documentation for gnutls is maintained as  a  Texinfo  manual.
56       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
57       visit
58
59       http://www.gnutls.org/manual/
60
61gnutls                              3.3.29               gnutls_record_recv(3)
Impressum