gnutls_ia_recv — read data from the TLS/IA protocol
#include <gnutls/extra.h>
ssize_t gnutls_ia_recv( |
gnutls_session_t | session, |
| char * | data, | |
| size_t | sizeofdata); |
is a gnutls_session_t structure.
the buffer that the data will be read into, must hold >= 12 bytes.
the number of requested bytes, must be >= 12.
Receive TLS/IA data. This function has the similar
semantics with recv(). The only
difference is that is accepts a GNUTLS session, and uses
different error codes.
If the server attempt to finish an application phase, this
function will return GNUTLS_E_WARNING_IA_IPHF_RECEIVED or
GNUTLS_E_WARNING_IA_FPHF_RECEIVED. The
caller should then invoke gnutls_ia_verify_endphase(), and if it runs
the client side, also send an endphase message of its own
using gnutls_ia_endphase_send.
If EINTR is returned by the internal push function (the
default is code{recv()}) then GNUTLS_E_INTERRUPTED will be returned. If
GNUTLS_E_INTERRUPTED or
GNUTLS_E_AGAIN is returned,
you must call this function again, with the same parameters;
alternatively you could provide a NULL pointer for data, and
0 for size.
The number of bytes received. A negative error code is returned in case of an error. The GNUTLS_E_WARNING_IA_IPHF_RECEIVED and GNUTLS_E_WARNING_IA_FPHF_RECEIVED errors are returned when an application phase finished message has been sent by the server.
The full documentation for gnutls is maintained as a Texinfo manual. If the info and gnutls programs are properly installed at your site, the command
info gnutls
should give you access to the complete manual.
| COPYRIGHT |
|---|
|
Copyright © 2008 Free Software Foundation. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. |