.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) .\" .\" 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_set_info_callback 3SSL" .TH fr::ssl::SSL_CTX_set_info_callback 3SSL "2015-01-30" "1.0.1k" "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_set_info_callback, SSL_CTX_get_info_callback, SSL_set_info_callback, SSL_get_info_callback \- Gestion du rappel d’information pour les connexions \&\s-1SSL\s0 .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fB #include \fR .PP \&\fB void SSL_CTX_set_info_callback(\s-1SSL_CTX\s0 *\fR\fIctx\fR\fB, void (*\fR\fIrappel\fR\fB)());\fR \fBvoid (*SSL_CTX_get_info_callback(const \s-1SSL_CTX\s0 *\fR\fIctx\fR\fB))();\fR .PP \&\fB void SSL_set_info_callback(\s-1SSL\s0 *\fR\fIssl\fR\fB, void (*\fR\fIrappel\fR\fB)());\fR \fBvoid (*SSL_get_info_callback(const \s-1SSL\s0 *\fR\fIssl\fR\fB))();\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBSSL_CTX_set_info_callback\fR() définit la fonction \fIrappel\fR, qui peut être utilisée pour obtenir l’information d’état pour des objets \s-1SSL\s0 créés à partir de \fIctx\fR pendant la configuration de la connexion et son utilisation. Le réglage pour \fIctx\fR est redéfini par la configuration pour un objet \s-1SSL\s0 spécifique, s’il existe. Si \fIrappel\fR est \s-1NULL,\s0 aucune fonction de rappel n’est utilisée. .PP \&\fBSSL_set_info_callback\fR() définit la fonction \fIrappel\fR, qui peut être utilisée pour l’information d’état pour \fIssl\fR pendant la configuration de la connexion et son utilisation. Si \fIrappel\fR est \s-1NULL,\s0 le réglage du rappel en cours pour \fIctx\fR est utilisé. .PP \&\fBSSL_CTX_get_info_callback\fR() renvoie un pointeur vers l’actuelle fonction de rappel d’information pour \fIctx\fR. .PP \&\fBSSL_get_info_callback\fR() renvoie un pointeur vers l’actuelle fonction de rappel d’information pour \fIssl\fR. .SH "NOTES" .IX Header "NOTES" Durant la configuration de connexion et son utilisation, il est possible d’obtenir des informations d’état du moteur \s-1SSL/TLS.\s0 Si définie, une fonction de rappel d’information est appelée à chaque fois que l’état change, une alerte apparait, ou une erreur survient. .PP La fonction de rappel est demandée ainsi : \fBrappel(\s-1SSL\s0 *\fR\fIssl\fR\fB, int \&\fR\fIoù\fR\fB, int\fR \fIret\fR\fB)\fR. L’argument \fIoù\fR précise l’information sur où (dans quel contexte) la fonction de rappel a été appelée. Si \fIret\fR est \&\fB0\fR, une condition d’erreur est survenue. Si une alerte est gérée, \&\s-1SSL_CB_ALERT\s0 est défini et \fIret\fR indique la connaissance d’une alerte. .PP \&\fIoù\fR est un masquage fait avec les éléments suivants. .IP "\s-1SSL_CB_LOOP\s0" 4 .IX Item "SSL_CB_LOOP" Le rappel a été demandé pour indiquer un changement d’état dans une boucle. .IP "\s-1SSL_CB_EXIT\s0" 4 .IX Item "SSL_CB_EXIT" Le rappel a été demandé pour indiquer une sortie d’erreur dans une fonction d’initiation de connexion (Peut être une erreur bénigne avec la possibilité de recommencer dans les configurations non bloquantes). .IP "\s-1SSL_CB_READ\s0" 4 .IX Item "SSL_CB_READ" Le rappel a été demandé pendant une opération de lecture. .IP "\s-1SSL_CB_WRITE\s0" 4 .IX Item "SSL_CB_WRITE" Le rappel a été demandé durant une opération d’écriture. .IP "\s-1SSL_CB_ALERT\s0" 4 .IX Item "SSL_CB_ALERT" Le rappel a été demandé à cause d’une alerte envoyée ou reçue. .IP "\s-1SSL_CB_READ_ALERT \s0(SSL_CB_ALERT|SSL_CB_READ)" 4 .IX Item "SSL_CB_READ_ALERT (SSL_CB_ALERT|SSL_CB_READ)" .PD 0 .IP "\s-1SSL_CB_WRITE_ALERT \s0(SSL_CB_ALERT|SSL_CB_WRITE)" 4 .IX Item "SSL_CB_WRITE_ALERT (SSL_CB_ALERT|SSL_CB_WRITE)" .IP "\s-1SSL_CB_ACCEPT_LOOP \s0(SSL_ST_ACCEPT|SSL_CB_LOOP)" 4 .IX Item "SSL_CB_ACCEPT_LOOP (SSL_ST_ACCEPT|SSL_CB_LOOP)" .IP "\s-1SSL_CB_ACCEPT_EXIT \s0(SSL_ST_ACCEPT|SSL_CB_EXIT)" 4 .IX Item "SSL_CB_ACCEPT_EXIT (SSL_ST_ACCEPT|SSL_CB_EXIT)" .IP "\s-1SSL_CB_CONNECT_LOOP \s0(SSL_ST_CONNECT|SSL_CB_LOOP)" 4 .IX Item "SSL_CB_CONNECT_LOOP (SSL_ST_CONNECT|SSL_CB_LOOP)" .IP "\s-1SSL_CB_CONNECT_EXIT \s0(SSL_ST_CONNECT|SSL_CB_EXIT)" 4 .IX Item "SSL_CB_CONNECT_EXIT (SSL_ST_CONNECT|SSL_CB_EXIT)" .IP "\s-1SSL_CB_HANDSHAKE_START\s0" 4 .IX Item "SSL_CB_HANDSHAKE_START" .PD Le rappel a été demandé car une nouvelle initialisation de connexion a commencé. .IP "\s-1SSL_CB_HANDSHAKE_DONE\s0 0x20" 4 .IX Item "SSL_CB_HANDSHAKE_DONE 0x20" Le rappel a été demandé parce que l’initialisation est terminée. .PP L’actuelle information d’état peut être obtenue avec la famille de fonctions \&\fBSSL_state_string\fR(3). .PP L’information \fIret\fR peut être évaluée avec la famille de fonctions \&\fBSSL_alert_type_string\fR(3). .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" \&\fBSSL_set_info_callback\fR() ne fournit pas d’information de diagnostic. .PP \&\fBSSL_get_info_callback\fR() renvoie le réglage actuel. .SH "EXEMPLES" .IX Header "EXEMPLES" L’exemple suivant de fonction de rappel écrit les chaînes d’état, l’information sur les alertes gérées et les messages d’erreur dans le \s-1BIO \&\s0\fIbio_err\fR. .PP .Vb 4 \& void apps_ssl_info_callback(SSL *s, int où, int ret) \& { \& const char *str; \& int w; \& \& w=où& ~SSL_ST_MASK; \& \& if (w & SSL_ST_CONNECT) str="SSL_connect"; \& else if (w & SSL_ST_ACCEPT) str="SSL_accept"; \& else str="undefined"; \& \& if (où & SSL_CB_LOOP) \& { \& BIO_printf(bio_err,"%s:%s\en",str,SSL_state_string_long(s)); \& } \& else if (où & SSL_CB_ALERT) \& { \& str=(où & SSL_CB_READ)?"read":"write"; \& BIO_printf(bio_err,"SSL3 alert %s:%s:%s\en", \& str, \& SSL_alert_type_string_long(ret), \& SSL_alert_desc_string_long(ret)); \& } \& else if (où & SSL_CB_EXIT) \& { \& if (ret == 0) \& BIO_printf(bio_err,"%s : erreur dans %s\en", \& str,SSL_state_string_long(s)); \& else if (ret < 0) \& { \& BIO_printf(bio_err,"%s : erreur dans %s\en", \& str,SSL_state_string_long(s)); \& } \& } \& } .Ve .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBssl\fR(3), \fBSSL_state_string\fR(3), \&\fBSSL_alert_type_string\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.