Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
gnutls_session_get_id2(3)	     gnutls	       gnutls_session_get_id2(3)

NAME
     gnutls_session_get_id2 - API function

SYNOPSIS
     #include <gnutls/gnutls.h>

     int  gnutls_session_get_id2(gnutls_session_t session, gnutls_datum_t * ses-
     sion_id);

ARGUMENTS
     gnutls_session_t session
		 is a gnutls_session_t type.

     gnutls_datum_t * session_id
		 will point to the session ID.

DESCRIPTION
     Returns the TLS session identifier. The  session  ID  is  selected  by  the
     server, and in older versions of TLS was a unique identifier shared between
     client  and  server  which was persistent across resumption.  In the latest
     version of TLS (1.3) or TLS 1.2 with session tickets, the notion of session
     identifiers is undefined and cannot be relied for uniquely identifying ses-
     sions across client and server.

     In client side this function returns the identifier returned by the server,
     and cannot be assumed to have  any  relation  to  session	resumption.   In
     server  side  this function is guaranteed to return a persistent identifier
     of the session since GnuTLS 3.6.4, which may not necessarily map  into  the
     TLS session ID value. Prior to that version the value could only be consid-
     ered  a  persistent identifier, under TLS1.2 or earlier and when no session
     tickets were in use.

     The session identifier value returned is always less  than  GNUTLS_MAX_SES-
     SION_ID_SIZE and should be treated as constant.

RETURNS
     On  success,  GNUTLS_E_SUCCESS  (0) is returned, otherwise an error code is
     returned.

SINCE
     3.1.4

REPORTING BUGS
     Report bugs to <bugs@gnutls.org>.
     Home page: https://www.gnutls.org

COPYRIGHT
     Copyright (C) 2001-2023 Free Software Foundation, Inc., and others.
     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.

SEE ALSO
     The full documentation for gnutls is maintained as a  Texinfo  manual.   If
     the  /usr/local/share/doc/gnutls/	directory does not contain the HTML form
     visit

     https://www.gnutls.org/manual/

gnutls				     3.8.13	       gnutls_session_get_id2(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_session_get_id2&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help