NOM¶
SSL_SESSION_free - Libérer une structure SSL_SESSION allouée
SYNOPSIS¶
#include <openssl/ssl.h>
void SSL_SESSION_free(SSL_SESSION *session);
DESCRIPTION¶
SSL_SESSION_free() décrémente le décompte de
références de
session et retire la structure
SSL_SESSION pointée par
session et libère la
mémoire allouée, si le décompte de
références atteint 0.
NOTES¶
Les objets SSL_SESSION sont alloués quand une poignée de main
TLS/SSL se termine avec succès. En fonction de la configuration,
consultez
SSL_CTX_set_session_cache_mode(3), les objets SSL_SESSION
sont référencés en interne par le SSL_CTX et
attachés dans son cache de sessions. Les objets SSL peuvent utiliser
l'objet SSL_SESSION ; comme une session peut être
réutilisée, plusieurs objets SSL peuvent utiliser le même
objet SSL_SESSION en même temps. Il est donc important de garder un
compte des références (informations sur l'utilisation) correct
et de ne pas supprimer un objet SSL_SESSION qui est encore utilisé, ce
qui pourrait conduire à des erreurs du programme du fait de pointeurs
pointant en l'air. Ces échecs peuvent aussi apparaître à
retardement, par exemple quand un objet SSL_SESSION a été
libéré parce que son décompte de références
est passé à zéro de façon erronée, mais est
toujours référencé dans le cache de sessions interne et
que la liste du cache est analysée lors d'une opération
SSL_CTX_flush_sessions(3).
SSL_SESSION_free() doit uniquement être appelée pour des
objets SSL_SESSION, pour lesquels le décompte de
référence a été incrémenté
explicitement (par exemple en appelant
SSL_get1_session(), consultez
SSL_get_session(3)) ou si l'objet SSL_SESSION a été
généré en dehors de l'opération de poignée
de main TLS, par exemple en utilisant
d2i_SSL_SESSION(3). Elle ne doit
pas être appelée avec les autres objets SSL_SESSION, puisque
cela résulterait en des décomptes de référence
erronés, et donc en des erreurs du programme.
VALEURS DE RETOUR¶
SSL_SESSION_free() ne fournit pas d'information de diagnostic.
VOIR AUSSI¶
ssl(3),
SSL_get_session(3),
SSL_CTX_set_session_cache_mode(3),
SSL_CTX_flush_sessions(3),
d2i_SSL_SESSION(3) =head1 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.