gnutls_range_split(3)

1gnutls_range_split(3)               gnutls               gnutls_range_split(3)
2
3
4

NAME

6       gnutls_range_split - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int  gnutls_range_split(gnutls_session_t session, const gnutls_range_st
12       * orig, gnutls_range_st * next, gnutls_range_st * remainder);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t type
17
18       const gnutls_range_st * orig
19                   is the original range provided by the user
20
21       gnutls_range_st * next
22                   is the returned range that can be conveyed in a TLS record
23
24       gnutls_range_st * remainder
25                   is the returned remaining range
26

DESCRIPTION

28       This function should be used when it is required to hide the length  of
29       very    long    data    that    cannot    be   directly   provided   to
30       gnutls_record_send_range().  In  that  case  this  function  should  be
31       called  with  the  desired  length hiding range in  orig . The returned
32       next   value   should   then   be   used   in   the   next   call    to
33       gnutls_record_send_range()  with the partial data.  That process should
34       be repeated until  remainder is (0,0).
35

RETURNS

37       0 in case splitting succeeds, non zero in case  of  error.   Note  that
38       orig is not changed, while the values of  next and  remainder are modi‐
39       fied to store the resulting values.
40

REPORTING BUGS

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

COPYRIGHT

47       Copyright © 2001-2020 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