6.8 Buffered data transfer

Although gnutls_record_send is sufficient to transmit data to the peer, when many small chunks of data are to be transmitted it is inefficient and wastes bandwidth due to the TLS record overhead. In that case it is preferrable to combine the small chunks before transmission. The following functions provide that functionality.

Function: void gnutls_record_cork (gnutls_session_t session)

session: is a gnutls_session_t structure.

If called gnutls_record_send() will no longer send partial records. All queued records will be sent when gnutls_uncork() is called, or when the maximum record size is reached.

This function is safe to use with DTLS after GnuTLS 3.3.0.

Since: 3.1.9

Function: int gnutls_record_uncork (gnutls_session_t session, unsigned int flags)

session: is a gnutls_session_t structure.

flags: Could be zero or GNUTLS_RECORD_WAIT

This resets the effect of gnutls_cork() , and flushes any pending data. If the GNUTLS_RECORD_WAIT flag is specified then this function will block until the data is sent or a fatal error occurs (i.e., the function will retry on GNUTLS_E_AGAIN and GNUTLS_E_INTERRUPTED ).

If the flag GNUTLS_RECORD_WAIT is not specified and the function is interrupted then the GNUTLS_E_AGAIN or GNUTLS_E_INTERRUPTED errors will be returned. To obtain the data left in the corked buffer use gnutls_record_check_corked() .

Returns: On success the number of transmitted data is returned, or otherwise a negative error code.

Since: 3.1.9

This document was generated on May 31, 2014 using texi2html 5.0.