.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.

.TH "gnutls_session_get_id" 3 "3.6.2" "gnutls" "gnutls"

.SH NAME

gnutls_session_get_id \- API function

.SH SYNOPSIS

.B #include <gnutls/gnutls.h>

.sp

.BI "int gnutls_session_get_id(gnutls_session_t " session ", void * " session_id ", size_t * " session_id_size ");"

.SH ARGUMENTS

.IP "gnutls_session_t session" 12

is a \fBgnutls_session_t\fP type.

.IP "void * session_id" 12

is a pointer to space to hold the session id.

.IP "size_t * session_id_size" 12

initially should contain the maximum  \fIsession_id\fP size and will be updated.

.SH "DESCRIPTION"

Returns the current session ID. This can be used if you want to

check if the next session you tried to resume was actually

resumed.  That is because resumed sessions share the same session ID

with the original session.

The session ID is selected by the server, that identify the

current session.  In all supported TLS protocols, the session id

is less than \fBGNUTLS_MAX_SESSION_ID_SIZE\fP.

.SH "RETURNS"

On success, \fBGNUTLS_E_SUCCESS\fP (0) is returned, otherwise

an error code is returned.

.SH "REPORTING BUGS"

Report bugs to <bugs@gnutls.org>.

.br

Home page: http://www.gnutls.org

.SH COPYRIGHT

Copyright \(co 2001-2018 Free Software Foundation, Inc., and others.

.br

Copying and distribution of this file, with or without modification,

are permitted in any medium without royalty provided the copyright

notice and this notice are preserved.

.SH "SEE ALSO"

The full documentation for

.B gnutls

is maintained as a Texinfo manual.

If the /usr/share/doc/gnutls/

directory does not contain the HTML form visit

.B

.IP http://www.gnutls.org/manual/

.PP