fr::ssl::SSL_get_session(3SSL)

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.