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 record packet size in this connection.
22
23       The requested record size does get in  effect  immediately  only  while
24       sending  data.  The  receive  part  will take effect after a successful
25       handshake.
26
27       Prior to 3.6.4, this function was implemented  using  a  TLS  extension
28       called  'max  record  size',  which  limits  the  acceptable  values to
29       512(=2^9), 1024(=2^10), 2048(=2^11) and 4096(=2^12).  Since  3.6.4,  it
30       uses  another  TLS  extension called 'record size limit', which doesn't
31       have the limitation, as long as the value ranges between 512 and 16384.
32       Note  that  not  all  TLS  implementations use or even understand those
33       extension.
34
35       In TLS 1.3, the value is the length of plaintext content plus its  pad‐
36       ding, excluding content type octet.
37

RETURNS

39       On  success,  GNUTLS_E_SUCCESS  (0)  is  returned, otherwise a negative
40       error code is returned.
41

REPORTING BUGS

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

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

SEE ALSO

54       The full documentation for gnutls is maintained as  a  Texinfo  manual.
55       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
56       visit
57
58       https://www.gnutls.org/manual/
59
60gnutls                               3.6.7       gnutls_record_set_max_size(3)
Impressum