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.

1.0.2a 1.0.2c                                      2015-12-31                    fr::ssl::SSL_SESSION_free(3SSL)