---
name: "gnutls_ia_send"
section: "3"
platform: "linux"
package: "gnutls-doc"
version: "2.8.6-1+squeeze3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_ia_send"
---

# gnutls\_ia\_send(3)

API function

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