Provided by: manpages-fr-extra_20080921_all bug

NOM

       SSL_SESSION_free - LibA~Xrer une structure SSL_SESSION allouA~Xe

SYNOPSIS

        #include <openssl/ssl.h>

        void SSL_SESSION_free(SSL_SESSION *session);

DESCRIPTION

       SSL_SESSION_free() dA~XcrA~Xmente le dA~Xcompte de rA~XfA~Xrences de
       session et retire la structure SSL_SESSION pointA~Xe par session et
       libA~Xre la mA~Xmoire allouA~Xe, si le dA~Xcompte de rA~XfA~Xrences
       atteint 0.

NOTES

       Les objets SSL_SESSION sont allouA~Xes quand une poignA~Xe de main
       TLS/SSL se termine avec succA~Xs. En fonction de la configuration,
       consultez SSL_CTX_set_session_cache_mode(3), les objets SSL_SESSION
       sont rA~XfA~XrencA~Xs en interne par le SSL_CTX et attachA~Xs son cache
       de sessions. Les objets SSL peuvent utiliser l’objet SSL_SESSION ;
       comme une session peut A~Xtre rA~XutilisA~Xe, plusieurs objets SSL
       peuvent utiliser le mA~Xme objet SSL_SESSION en mA~Xme temps. Il est
       donc important de garder un compte des rA~XfA~Xrences (informations sur
       l’utilisation) correct et de ne pas supprimer un objet SSL_SESSION qui
       est encore utilisA~X, ce qui pourrait conduire A~  des erreurs du
       programme du fait de pointeurs pointant en l’air. Ces A~Xchecs peuvent
       aussi apparaA~Xtre A~  retardement, par exemple quand un objet
       SSL_SESSION a A~XtA~X libA~XrA~X parce son dA~Xcompte de rA~XfA~Xrences
       est passA~X A~  zA~Xro de faA~Xon erronA~Xe, mais est toujours
       rA~XfA~XrencA~X dans le cache de sessions interne et que la liste du
       cache est analysA~Xe lors d’une opA~Xration SSL_CTX_flush_sessions(3).

       SSL_SESSION_free() doit uniquement A~Xtre appelA~Xe pour des objets
       SSL_SESSION, pour lesquels le dA~Xcompte de rA~XfA~Xrence a A~XtA~X
       incrA~XmentA~X explicitement (par exemple en appelant
       SSL_get1_session(), consultez SSL_get_session(3)) ou si l’objet
       SSL_SESSION a A~XtA~X gA~XnA~XrA~X en dehors de l’opA~Xration de
       poignA~Xe de main TLS, par exemple en utilisant d2i_SSL_SESSION(3).
       Elle ne doit pas A~Xtre appelA~Xe avec les autres objets SSL_SESSION,
       puisque A~Xa rA~Xsultera en des dA~Xcompte de rA~XfA~Xrence erronA~Xs,
       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)