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.