NOM
SSL_SESSION_free - Libérer une structure SSL_SESSION allouée
SYNOPSIS
#include <openssl/ssl.h>
void SSL_SESSION_free(SSL_SESSION *session);
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ées 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 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 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 ça résultera en des décompte 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.