1gnutls_ia_recv(3)                   gnutls                   gnutls_ia_recv(3)
2
3
4

NAME

6       gnutls_ia_recv - API function
7

SYNOPSIS

9       #include <gnutls/extra.h>
10
11       ssize_t  gnutls_ia_recv(gnutls_session_t  session,  char * data, size_t
12       sizeofdata);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t structure.
17
18       char * data the buffer that the data will be read into, must hold >= 12
19                   bytes.
20
21       size_t sizeofdata
22                   the number of requested bytes, must be >= 12.
23

DESCRIPTION

25       Receive  TLS/IA  data.   This  function  has the similar semantics with
26       recv().  The only difference is that it accepts a GnuTLS  session,  and
27       uses different error codes.
28
29       If  the  server  attempt  to finish an application phase, this function
30       will   return   GNUTLS_E_WARNING_IA_IPHF_RECEIVED   or   GNUTLS_E_WARN‐
31       ING_IA_FPHF_RECEIVED.   The  caller  should  then invoke gnutls_ia_ver‐
32       ify_endphase(), and if it runs the client side, also send  an  endphase
33       message of its own using gnutls_ia_endphase_send.
34
35       If  EINTR  is  returned  by  the internal push function (the default is
36       code{recv()})  then  GNUTLS_E_INTERRUPTED   will   be   returned.    If
37       GNUTLS_E_INTERRUPTED  or GNUTLS_E_AGAIN is returned, you must call this
38       function again, with the same parameters; alternatively you could  pro‐
39       vide a NULL pointer for data, and 0 for size.
40

RETURNS

42       The  number  of  bytes  received.  A negative error code is returned in
43       case  of   an   error.    The   GNUTLS_E_WARNING_IA_IPHF_RECEIVED   and
44       GNUTLS_E_WARNING_IA_FPHF_RECEIVED  errors are returned when an applica‐
45       tion phase finished message has been sent by the server.
46

REPORTING BUGS

48       Report   bugs   to    <bug-gnutls@gnu.org>.     GnuTLS    home    page:
49       http://www.gnu.org/software/gnutls/  General  help  using GNU software:
50       http://www.gnu.org/gethelp/
51

53       Copyright © 2008 Free Software Foundation.
54       Copying and distribution of this file, with  or  without  modification,
55       are  permitted  in  any  medium  without royalty provided the copyright
56       notice and this notice are preserved.
57

SEE ALSO

59       The full documentation for gnutls is maintained as  a  Texinfo  manual.
60       If  the  info  and gnutls programs are properly installed at your site,
61       the command
62
63              info gnutls
64
65       should give you access to the complete manual.
66
67
68
69gnutls                             2.12.6.1                  gnutls_ia_recv(3)
Impressum