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.

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.