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

NAME

6       gnutls_ia_recv - read data from the TLS/IA protocol
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 is 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
41       Returns  the  number  of  bytes  received.   A  negative  error code is
42       returned in case of an  error.   The  GNUTLS_E_WARNING_IA_IPHF_RECEIVED
43       and  GNUTLS_E_WARNING_IA_FPHF_RECEIVED  errors  are  returned  when  an
44       application phase finished message has been sent by the server.
45

REPORTING BUGS

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

50       Copyright © 2006 Free Software Foundation.
51       Permission is granted to make and distribute verbatim  copies  of  this
52       manual  provided  the  copyright  notice and this permission notice are
53       preserved on all copies.
54

SEE ALSO

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