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.

1.0.2a 1.0.2c                                      2015-12-31                     fr::ssl::SSL_get_session(3SSL)