1gnutls_session_get_id2(3)           gnutls           gnutls_session_get_id2(3)
2
3
4

NAME

6       gnutls_session_get_id2 - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int  gnutls_session_get_id2(gnutls_session_t  session, gnutls_datum_t *
12       session_id);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t type.
17
18       gnutls_datum_t * session_id
19                   will point to the session ID.
20

DESCRIPTION

22       Returns the TLS session identifier. The session ID is selected  by  the
23       server, and in older versions of TLS was a unique identifier shared be‐
24       tween client and server which was persistent across resumption.  In the
25       latest version of TLS (1.3) or TLS 1.2 with session tickets, the notion
26       of session identifiers is undefined and cannot be relied  for  uniquely
27       identifying sessions across client and server.
28
29       In  client  side  this  function returns the identifier returned by the
30       server, and cannot be assumed to have any relation to  session  resump‐
31       tion.   In  server side this function is guaranteed to return a persis‐
32       tent identifier of the session since GnuTLS 3.6.4, which may not neces‐
33       sarily  map  into  the  TLS session ID value. Prior to that version the
34       value could only be considered a persistent identifier, under TLS1.2 or
35       earlier and when no session tickets were in use.
36
37       The   session   identifier   value   returned   is   always  less  than
38       GNUTLS_MAX_SESSION_ID_SIZE and should be treated as constant.
39

RETURNS

41       On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an  error  code
42       is returned.
43

SINCE

45       3.1.4
46

REPORTING BUGS

48       Report bugs to <bugs@gnutls.org>.
49       Home page: https://www.gnutls.org
50
51
53       Copyright © 2001-2023 Free Software Foundation, Inc., and others.
54       Copying  and  distribution  of this file, with or without modification,
55       are permitted in any medium without royalty provided the copyright  no‐
56       tice and this notice are preserved.
57

SEE ALSO

59       The  full  documentation  for gnutls is maintained as a Texinfo manual.
60       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
61       visit
62
63       https://www.gnutls.org/manual/
64
65gnutls                               3.8.2           gnutls_session_get_id2(3)
Impressum