|
Packit Service |
4684c1 |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
4684c1 |
.TH "gnutls_session_get_id" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit Service |
4684c1 |
.SH NAME
|
|
Packit Service |
4684c1 |
gnutls_session_get_id \- API function
|
|
Packit Service |
4684c1 |
.SH SYNOPSIS
|
|
Packit Service |
4684c1 |
.B #include <gnutls/gnutls.h>
|
|
Packit Service |
4684c1 |
.sp
|
|
Packit Service |
4684c1 |
.BI "int gnutls_session_get_id(gnutls_session_t " session ", void * " session_id ", size_t * " session_id_size ");"
|
|
Packit Service |
4684c1 |
.SH ARGUMENTS
|
|
Packit Service |
4684c1 |
.IP "gnutls_session_t session" 12
|
|
Packit Service |
4684c1 |
is a \fBgnutls_session_t\fP type.
|
|
Packit Service |
4684c1 |
.IP "void * session_id" 12
|
|
Packit Service |
4684c1 |
is a pointer to space to hold the session id.
|
|
Packit Service |
4684c1 |
.IP "size_t * session_id_size" 12
|
|
Packit Service |
4684c1 |
initially should contain the maximum \fIsession_id\fP size and will be updated.
|
|
Packit Service |
4684c1 |
.SH "DESCRIPTION"
|
|
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 |
\fBGNUTLS_MAX_SESSION_ID_SIZE\fP.
|
|
Packit Service |
4684c1 |
.SH "RETURNS"
|
|
Packit Service |
4684c1 |
On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise
|
|
Packit Service |
4684c1 |
an error code is returned.
|
|
Packit Service |
4684c1 |
.SH "REPORTING BUGS"
|
|
Packit Service |
4684c1 |
Report bugs to <bugs@gnutls.org>.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Home page: https://www.gnutls.org
|
|
Packit Service |
4684c1 |
|
|
Packit Service |
4684c1 |
.SH COPYRIGHT
|
|
Packit Service |
4684c1 |
Copyright \(co 2001- Free Software Foundation, Inc., and others.
|
|
Packit Service |
4684c1 |
.br
|
|
Packit Service |
4684c1 |
Copying and distribution of this file, with or without modification,
|
|
Packit Service |
4684c1 |
are permitted in any medium without royalty provided the copyright
|
|
Packit Service |
4684c1 |
notice and this notice are preserved.
|
|
Packit Service |
4684c1 |
.SH "SEE ALSO"
|
|
Packit Service |
4684c1 |
The full documentation for
|
|
Packit Service |
4684c1 |
.B gnutls
|
|
Packit Service |
4684c1 |
is maintained as a Texinfo manual.
|
|
Packit Service |
4684c1 |
If the /usr/share/doc/gnutls/
|
|
Packit Service |
4684c1 |
directory does not contain the HTML form visit
|
|
Packit Service |
4684c1 |
.B
|
|
Packit Service |
4684c1 |
.IP https://www.gnutls.org/manual/
|
|
Packit Service |
4684c1 |
.PP
|