gnutls_record_set_max_size(3) — Linux manual page

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | DEPRECATED | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON

gnutls_record_set_max_size(3)    gnutls    gnutls_record_set_max_size(3)

NAME         top

       gnutls_record_set_max_size - API function

SYNOPSIS         top

       #include <gnutls/gnutls.h>

       ssize_t gnutls_record_set_max_size(gnutls_session_t session,
       size_t size);

ARGUMENTS         top

       gnutls_session_t session
                   is a gnutls_session_t type.

       size_t size is the new size

DESCRIPTION         top

       This function sets the maximum amount of plaintext sent and
       received in a record in this connection.

       Prior to 3.6.4, this function was implemented using a TLS
       extension called 'max fragment length', which limits the
       acceptable values to 512(=2^9), 1024(=2^10), 2048(=2^11) and
       4096(=2^12).

       Since 3.6.4, the limit is also negotiated through a new TLS
       extension called 'record size limit', which doesn't have the
       limitation, as long as the value ranges between 512 and 16384.
       Note that while the 'record size limit' extension is preferred,
       not all TLS implementations use or even understand the extension.

DEPRECATED         top

       if the client can assume that the 'record size limit' extension
       is supported by the server, we recommend using
       gnutls_record_set_max_recv_size() instead.

RETURNS         top

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

REPORTING BUGS         top

       Report bugs to <[email protected]>.
       Home page: https://www.gnutls.org

COPYRIGHT         top

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

SEE ALSO         top

       The full documentation for gnutls is maintained as a Texinfo
       manual.  If the /usr/share/doc/gnutls/ directory does not contain
       the HTML form visit

       https://www.gnutls.org/manual/

COLOPHON         top

       This page is part of the GnuTLS (GnuTLS Transport Layer Security
       Library) project.  Information about the project can be found at
       ⟨http://www.gnutls.org/⟩.  If you have a bug report for this
       manual page, send it to [email protected].  This page was obtained
       from the tarball gnutls-3.8.5.tar.xz fetched from
       ⟨http://www.gnutls.org/download.html⟩ on 2024-06-14.  If you
       discover any rendering problems in this HTML version of the page,
       or you believe there is a better or more up-to-date source for
       the page, or you have corrections or improvements to the
       information in this COLOPHON (which is not part of the original
       manual page), send a mail to [email protected]

gnutls                            3.8.5    gnutls_record_set_max_size(3)