gnutls_ia_send

Section: gnutls (3)
Updated: 2.8.5
Index Return to Main Contents
 

NAME

gnutls_ia_send - API function  

SYNOPSIS

#include <gnutls/extra.h>

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

ARGUMENTS

gnutls_session_t session
is a gnutls_session_t structure.
const char * data
contains the data to send
size_t sizeofdata
is the length of the data
 

DESCRIPTION

Send TLS/IA application payload data. This function has the similar semantics with send(). The only difference is that it accepts a GnuTLS session, and uses different error codes.

The TLS/IA protocol is synchronous, so you cannot send more than one packet at a time. The client always send the first packet.

To finish an application phase in the server, use gnutls_ia_endphase_send(). The client cannot end an application phase unilaterally; rather, a client is required to respond with an endphase of its own if gnutls_ia_recv indicates that the server has sent one.

If the EINTR is returned by the internal push function (the default is send()} 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.  

RETURNS

The number of bytes sent, or a negative error code.  

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 © 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.