gnutls_record_set_max_size(3)

1gnutls_record_set_max_size(3)       gnutls       gnutls_record_set_max_size(3)
2
3
4

NAME

6       gnutls_record_set_max_size - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       ssize_t   gnutls_record_set_max_size(gnutls_session_t  session,  size_t
12       size);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t type.
17
18       size_t size is the new size
19

DESCRIPTION

21       This function sets the maximum amount of plaintext sent and received in
22       a record in this connection.
23
24       Prior  to  3.6.4,  this  function was implemented using a TLS extension
25       called 'max fragment length', which limits  the  acceptable  values  to
26       512(=2^9), 1024(=2^10), 2048(=2^11) and 4096(=2^12).
27
28       Since  3.6.4,  the limit is also negotiated through a new TLS extension
29       called 'record size limit', which doesn't have the limitation, as  long
30       as the value ranges between 512 and 16384.  Note that while the 'record
31       size limit' extension is preferred, not all TLS implementations use  or
32       even understand the extension.
33

DEPRECATED

35       if the client can assume that the 'record size limit' extension is sup‐
36       ported      by      the      server,      we      recommend       using
37       gnutls_record_set_max_recv_size() instead.
38

RETURNS

40       On  success,  GNUTLS_E_SUCCESS  [22m(0)  is  returned, otherwise a negative
41       error code is returned.
42

REPORTING BUGS

44       Report bugs to <bugs@gnutls.org>.
45       Home page: https://www.gnutls.org
46
47

COPYRIGHT

49       Copyright © 2001-2020 Free Software Foundation, Inc., and others.
50       Copying and distribution of this file, with  or  without  modification,
51       are  permitted  in  any  medium  without royalty provided the copyright
52       notice and this notice are preserved.
53