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 type.
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 the peer requests a renegotiation, the
27       caller  will receive an error code of GNUTLS_E_REHANDSHAKE.  In case of
28       a client, this message may be simply ignored,  replied  with  an  alert
29       GNUTLS_A_NO_RENEGOTIATION,  or  replied with a new handshake, depending
30       on the client's will. A server receiving this error code can only  ini‐
31       tiate a new handshake or terminate the session.
32
33       If  EINTR  is  returned  by  the internal pull function (the default is
34       recv()) then GNUTLS_E_INTERRUPTED will be returned.  If GNUTLS_E_INTER‐
35       RUPTED or GNUTLS_E_AGAIN is returned, you must call this function again
36       to get the data.  See also gnutls_record_get_direction().
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: https://www.gnutls.org
46
47

49       Copyright © 2001- Free Software Foundation, Inc., and others.
50       Copying and distribution of this file, with  or  without  modification,
51       are  permitted in any medium without royalty provided the copyright no‐
52       tice 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       https://www.gnutls.org/manual/
60
61gnutls                               3.7.8               gnutls_record_recv(3)
Impressum