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
24       between client and server which was persistent across  resumption.   In
25       the  latest  version  of TLS (1.3) or TLS 1.2 with session tickets, the
26       notion of session identifiers is undefined and  cannot  be  relied  for
27       uniquely 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-2019 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
56       notice 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.6.11           gnutls_session_get_id2(3)
Impressum