.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{ . if \nF \{ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "fr::ssl::SSL_CTX_sess_set_get_cb 3SSL" .TH fr::ssl::SSL_CTX_sess_set_get_cb 3SSL "2015-12-31" "1.0.2a 1.0.2c" "OpenSSL" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NOM" .IX Header "NOM" SSL_CTX_sess_set_new_cb, SSL_CTX_sess_set_remove_cb, SSL_CTX_sess_set_get_cb, SSL_CTX_sess_get_new_cb, SSL_CTX_sess_get_remove_cb, SSL_CTX_sess_get_get_cb \- Fournir des fonctions de rappel pour la mise en cache de sessions externe du côté serveur .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& #include \& \& void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx, \& int (*new_session_cb)(SSL *, SSL_SESSION *)); \& void SSL_CTX_sess_set_remove_cb(SSL_CTX *ctx, \& void (*remove_session_cb)(SSL_CTX *ctx, SSL_SESSION *)); \& void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx, \& SSL_SESSION (*get_session_cb)(SSL *, unsigned char *, int, int *)); \& \& int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(struct ssl_st *ssl, SSL_SESSION *sess); \& void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(struct ssl_ctx_st *ctx, SSL_SESSION *sess); \& SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(struct ssl_st *ssl, unsigned char *data, int len, int *copy); \& \& int (*new_session_cb)(struct ssl_st *ssl, SSL_SESSION *sess); \& void (*remove_session_cb)(struct ssl_ctx_st *ctx, SSL_SESSION *sess); \& SSL_SESSION *(*get_session_cb)(struct ssl_st *ssl, unsigned char *data, \& int len, int *copy); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBSSL_CTX_sess_set_new_cb\fR() configure la fonction de rappel qui est automatiquement appelée chaque fois qu'une nouvelle session a été négociée. .PP \&\fBSSL_CTX_sess_set_remove_cb\fR() configure la fonction de rappel qui est automatiquement appelée chaque fois qu'une session a été supprimée par le moteur \s-1SSL,\s0 parce qu'elle est considérée fautive ou parce que la session est devenue obsolète par dépassement de la valeur du délai d'expiration. .PP \&\fBSSL_CTX_sess_set_get_cb\fR() configure la fonction de rappel qui est appelée chaque fois qu'un client \s-1SSL/TLS\s0 a proposé de reprendre une session mais qu'elle ne peut pas être trouvée dans le cache de sessions interne (voir \&\fBSSL_CTX_set_session_cache_mode\fR(3)), (seulement pour les serveurs \s-1SSL/TLS\s0) .PP \&\fBSSL_CTX_sess_get_new_cb\fR(), \fBSSL_CTX_sess_get_remove_cb\fR(), et \&\fBSSL_CTX_sess_get_get_cb\fR() permettent de récupérer les pointeurs de fonction des fonctions de rappel fournies. Si une fonction de rappel n'a pas été configurée, le pointeur \s-1NULL\s0 est renvoyé. .SH "NOTES" .IX Header "NOTES" Afin de permettre la mise en cache externe de session, la synchronisation avec le cache interne de session est réalisée par les fonctions de rappel.Dans les fonctions de rappel, la session peut être sauvegardée sur le disque ou mise dans une base de données en utilisant l'interface \&\fBd2i_SSL_SESSION\fR(3). .PP La fonction \fBnew_session_cb\fR() est appelée chaque fois qu'une nouvelle session a été négociée et que la mise en cache de sessions est activée (voir \&\fBSSL_CTX_set_session_cache_mode\fR(3)). La fonction \fBnew_session_cb\fR() est passée à la connexion \fIssl\fR et à la session \s-1SSL \s0\fIsess\fR. Si le rappel renvoie \fB0\fR, la session sera à nouveau immédiatement supprimée. .PP La fonction \fBremove_session_cb\fR() est appelée chaque fois que le moteur \s-1SSL\s0 supprime une session du cache interne. Cela se produit quand la session est supprimée parce qu'elle est expirée ou quand une connexion n'a pas été fermée proprement. Cela arrive aussi pour toutes les sessions dans le cache de sessions interne lorsque \fBSSL_CTX_free\fR(3) est appelée. La fonction \fBremove_session_cb\fR() est passée à \fIctx\fR et à la session \s-1SSL \s0\fIsess\fR. Elle ne renvoie aucun message. .PP La fonction \fBget_session_cb\fR() est seulement appelée sur les serveurs \&\s-1SSL/TLS\s0 avec l'identifiant de session proposé par le client. La fonction \&\fBget_session_cb\fR() est toujours appelée, même si la mise en cache de session a été désactivée. La fonction \fBget_session_cb\fR() est passée à la connexion \fIssl\fR, l'identifiant de session de longueur \fIlength\fR à l'emplacement mémoire \fIdata\fR. Avec le paramètre \fIcopy\fR le rappel peut nécessiter que le moteur \s-1SSL\s0 incrémente le compteur de références de l'objet \&\fB\s-1SSL_SESSION\s0\fR. Normalement, le compteur de références n'est pas incrémenté et ainsi la session ne doit pas être explicitement libérée avec \&\fBSSL_SESSION_free\fR(3). .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBssl\fR(3), \fBd2i_SSL_SESSION\fR(3), \&\fBSSL_CTX_set_session_cache_mode\fR(3), \&\fBSSL_CTX_flush_sessions\fR(3), \&\fBSSL_SESSION_free\fR(3), \&\fBSSL_CTX_free\fR(3) .SH "TRADUCTION" .IX Header "TRADUCTION" La traduction de cette page de manuel est maintenue par les membres de la liste . Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.