NOM

       SSL_get_session - Récupération de données de session TLS/SSL

SYNOPSIS

        #include <openssl/ssl.h>

        SSL_SESSION *SSL_get_session(const SSL *ssl);
        SSL_SESSION *SSL_get0_session(const SSL *ssl);
        SSL_SESSION *SSL_get1_session(SSL *ssl);

DESCRIPTION

       SSL_get_session() renvoie un pointeur vers la SSL_SESSION vraiment utilisée par ssl. Le
       compteur de références de la SSL_SESSION n'est pas incrémenté, de telle sorte que le
       pointeur peut être rendu incorrect par d'autres applications.

       SSL_get0_session() est identique à SSL_get_session().

       SSL_get1_session() est identique à SSL_get_session(), mais le compteur de références de la
       SSL_SESSION est incrémenté d'un.

NOTES

       La session SSL contient toutes les informations nécessaires pour rétablir la connexion
       sans nouvelle initiation de connexion.

       SSL_get_session() renvoie un pointeur vers la véritable session. Comme le compteur de
       références n'est pas incrémenté, le pointeur n'est valable que tant que la connexion est
       utilisée. Si SSL_clear(3) ou SSL_free(3) sont appelées, la session pourrait être
       complètement supprimée (si considérée mauvaise) et le pointeur obtenu pourrait devenir
       incorrect. Même si la session est valable, elle peut être supprimée à tout moment à cause
       d'un délai dépassé pendant SSL_CTX_flush_sessions(3).

       Si les données sont gardées, SSL_get1_session() incrémentera le compteur de références, de
       telle sorte que la session ne soit pas implicitement supprimée par d'autres opérations
       mais reste en mémoire. Pour supprimer la session, SSL_SESSION_free(3) doit être appelée
       explicitement une fois pour décrémenter de nouveau le compteur de références.

       Les objets SSL_SESSION conservent des informations internes sur les liens à propos de la
       liste du cache de sessions, lorsqu'ils sont insérés dans le cache de sessions d'un objet
       SSL_CTX. Un objet SSL_SESSION, quel que soit son compteur de références, ne doit donc être
       utilisé qu'avec un objet SSL_CTX (et les objets SSL créés à partir de cet objet SSL_CTX).

VALEURS DE RETOUR

       Les valeurs suivantes peuvent être renvoyées.

       NULL
           Il n'y a pas de session disponible dans ssl.

       Pointeur vers une structure SSL
           La valeur de retour pointe vers les données d'une session SSL.

VOIR AUSSI

       ssl(3), SSL_clear(3), SSL_free(3), SSL_SESSION_free(3)

TRADUCTION

       La traduction de cette page de manuel est maintenue par les membres de la liste
       <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de
       traduction par un rapport de bogue sur le paquet manpages-fr-extra.