|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@deftypefun {int} {gnutls_session_get_id} (gnutls_session_t @var{session}, void * @var{session_id}, size_t * @var{session_id_size})
|
|
Packit Service |
4684c1 |
@var{session}: is a @code{gnutls_session_t} type.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{session_id}: is a pointer to space to hold the session id.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@var{session_id_size}: initially should contain the maximum @code{session_id} size and will be updated.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
Returns the TLS session identifier. The session ID is selected by the
|
|
Packit Service |
4684c1 |
server, and in older versions of TLS was a unique identifier shared
|
|
Packit Service |
4684c1 |
between client and server which was persistent across resumption.
|
|
Packit Service |
4684c1 |
In the latest version of TLS (1.3) or TLS with session tickets, the
|
|
Packit Service |
4684c1 |
notion of session identifiers is undefined and cannot be relied for uniquely
|
|
Packit Service |
4684c1 |
identifying sessions across client and server.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
In client side this function returns the identifier returned by the
|
|
Packit Service |
4684c1 |
server, and cannot be assumed to have any relation to session resumption.
|
|
Packit Service |
4684c1 |
In server side this function is guaranteed to return a persistent
|
|
Packit Service |
4684c1 |
identifier of the session since GnuTLS 3.6.4, which may not necessarily
|
|
Packit Service |
4684c1 |
map into the TLS session ID value. Prior to that version the value
|
|
Packit Service |
4684c1 |
could only be considered a persistent identifier, under TLS1.2 or earlier
|
|
Packit Service |
4684c1 |
and when no session tickets were in use.
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
The session identifier value returned is always less than
|
|
Packit Service |
4684c1 |
@code{GNUTLS_MAX_SESSION_ID_SIZE} .
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
@strong{Returns:} On success, @code{GNUTLS_E_SUCCESS} (0) is returned, otherwise
|
|
Packit Service |
4684c1 |
an error code is returned.
|
|
Packit Service |
4684c1 |
@end deftypefun
|