doc/manpages/gnutls_ia_send.3

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
   2 .TH "gnutls_ia_send" 3 "2.12.6.1" "gnutls" "gnutls"
   3 .SH NAME
   4 gnutls_ia_send \- API function
   5 .SH SYNOPSIS
   6 .B #include <gnutls/extra.h>
   7 .sp
   8 .BI "ssize_t gnutls_ia_send(gnutls_session_t " session ", const char * " data ", size_t " sizeofdata ");"
   9 .SH ARGUMENTS
  10 .IP "gnutls_session_t session" 12
  11 is a \fBgnutls_session_t\fP structure.
  12 .IP "const char * data" 12
  13 contains the data to send
  14 .IP "size_t sizeofdata" 12
  15 is the length of the data
  16 .SH "DESCRIPTION"
  17 Send TLS/IA application payload data.  This function has the
  18 similar semantics with \fBsend()\fP.  The only difference is that it
  19 accepts a GnuTLS session, and uses different error codes.
  20
  21 The TLS/IA protocol is synchronous, so you cannot send more than
  22 one packet at a time.  The client always send the first packet.
  23
  24 To finish an application phase in the server, use
  25 \fBgnutls_ia_endphase_send()\fP.  The client cannot end an application
  26 phase unilaterally; rather, a client is required to respond with an
  27 endphase of its own if gnutls_ia_recv indicates that the server has
  28 sent one.
  29
  30 If the EINTR is returned by the internal push function (the default
  31 is \fBsend()\fP} then \fBGNUTLS_E_INTERRUPTED\fP will be returned.  If
  32 \fBGNUTLS_E_INTERRUPTED\fP or \fBGNUTLS_E_AGAIN\fP is returned, you must call
  33 this function again, with the same parameters; alternatively you
  34 could provide a \fBNULL\fP pointer for data, and 0 for size.
  35 .SH "RETURNS"
  36 The number of bytes sent, or a negative error code.
  37 .SH "REPORTING BUGS"
  38 Report bugs to <bug-gnutls@gnu.org>.
  39 GnuTLS home page: http://www.gnu.org/software/gnutls/
  40 General help using GNU software: http://www.gnu.org/gethelp/
  41 .SH COPYRIGHT
  42 Copyright \(co 2008 Free Software Foundation.
  43 .br
  44 Copying and distribution of this file, with or without modification,
  45 are permitted in any medium without royalty provided the copyright
  46 notice and this notice are preserved.
  47 .SH "SEE ALSO"
  48 The full documentation for
  49 .B gnutls
  50 is maintained as a Texinfo manual.  If the
  51 .B info
  52 and
  53 .B gnutls
  54 programs are properly installed at your site, the command
  55 .IP
  56 .B info gnutls
  57 .PP
  58 should give you access to the complete manual.