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       This property can only be set to clients.  The server may choose not to
23       accept the requested size.
24
25       The requested record size does get in  effect  immediately  only  while
26       sending  data.  The  receive  part  will take effect after a successful
27       handshake.
28
29       Prior to 3.6.4, this function was implemented  using  a  TLS  extension
30       called  'max  record  size',  which  limits  the  acceptable  values to
31       512(=2^9), 1024(=2^10), 2048(=2^11) and 4096(=2^12).  Since  3.6.4,  it
32       uses  another  TLS  extension called 'record size limit', which doesn't
33       have the limitation, as long as the value ranges between 512 and 16384.
34       Note  that  not  all  TLS  implementations use or even understand those
35       extension.
36

RETURNS

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

REPORTING BUGS

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

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

SEE ALSO

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