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.