



@deftypefun {ssize_t} {gnutls_record_set_max_size} (gnutls_session_t @var{session}, size_t @var{size})
@var{session}: is a @code{gnutls_session_t}  type.

@var{size}: is the new size

This function sets the maximum record packet size in this
connection.  This property can only be set to clients.  The server
may choose not to accept the requested size.

The requested record size does get in effect immediately only while
sending data. The receive part will take effect after a successful
handshake.

Prior to 3.6.4, this function was implemented using a TLS extension
called 'max record size', which limits the acceptable values to
512(=2^9), 1024(=2^10), 2048(=2^11) and 4096(=2^12). Since 3.6.4,
it uses another TLS extension called 'record size limit', which
doesn't have the limitation, as long as the value ranges between
512 and 16384.  Note that not all TLS implementations use or even
understand those extension.

@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS}  (0) is returned,
otherwise a negative error code is returned.
@end deftypefun
