1gnutls_session_get_id(3)            gnutls            gnutls_session_get_id(3)
2
3
4

NAME

6       gnutls_session_get_id - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int  gnutls_session_get_id(gnutls_session_t session, void * session_id,
12       size_t * session_id_size);
13

ARGUMENTS

15       gnutls_session_t session
16                   is a gnutls_session_t type.
17
18       void * session_id
19                   is a pointer to space to hold the session id.
20
21       size_t * session_id_size
22                   initially should contain the maximum  session_id  size  and
23                   will be updated.
24

DESCRIPTION

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

RETURNS

45       On  success,  GNUTLS_E_SUCCESS (0) is returned, otherwise an error code
46       is returned.
47

REPORTING BUGS

49       Report bugs to <bugs@gnutls.org>.
50       Home page: http://www.gnutls.org
51
52

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

SEE ALSO

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