DragonFly On-Line Manual Pages

Search: Section:  

gnutls_ia_recv(3)		    gnutls		     gnutls_ia_recv(3)


NAME

       gnutls_ia_recv - API function


SYNOPSIS

       #include <gnutls/extra.h>

       ssize_t	gnutls_ia_recv(gnutls_session_t  session,  char * data, size_t
       sizeofdata);


ARGUMENTS

       gnutls_session_t session
		   is a gnutls_session_t structure.

       char * data the buffer that the data will be read into, must hold >= 12
		   bytes.

       size_t sizeofdata
		   the number of requested bytes, must be >= 12.


DESCRIPTION

       Receive	TLS/IA	data.	This  function	has the similar semantics with
       recv().	The only difference is that it 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_WARN-
       ING_IA_FPHF_RECEIVED.   The  caller  should  then invoke gnutls_ia_ver-
       ify_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  pro-
       vide a NULL pointer for data, and 0 for size.


RETURNS

       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 applica-
       tion phase finished message has been sent by the server.


REPORTING BUGS

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


COPYRIGHT

       Copyright (C) 2008 Free Software Foundation.
       Copying and distribution of this file, with  or	without  modification,
       are  permitted  in  any	medium	without royalty provided the copyright
       notice and this notice are preserved.


SEE ALSO

       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.

gnutls				   2.12.6.1		     gnutls_ia_recv(3)

Search: Section: