.\" 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_set_msg_callback 3SSL" .TH fr::ssl::SSL_CTX_set_msg_callback 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_set_msg_callback, SSL_CTX_set_msg_callback_arg, SSL_set_msg_callback, SSL_get_msg_callback_arg \- Installer le rappel pour l’observation des messages de protocole .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fB #include \fR .PP \&\fB void SSL_CTX_set_msg_callback(\s-1SSL_CTX\s0 *\fR\fIctx\fR\fB, void (*\fR\fIcb\fR\fB)(int\fR \fIwrite_p\fR\fB, int\fR \fIversion\fR\fB, int\fR \fIcontent_type\fR\fB, const void *\fR\fItamp\fR\fB, size_t\fR \fItaille\fR\fB, \s-1SSL\s0 *\fR\fIssl\fR\fB, void *\fR\fIarg\fR\fB));\fR \fBvoid SSL_CTX_set_msg_callback_arg(\s-1SSL_CTX\s0 *\fR\fIctx\fR\fB, void *\fR\fIarg\fR\fB);\fR .PP \&\fB void SSL_set_msg_callback(\s-1SSL\s0 *\fR\fIssl\fR\fB, void (*\fR\fIcb\fR\fB)(int\fR \fIwrite_p\fR\fB, int\fR \fIversion\fR\fB, int\fR \fIcontent_type\fR\fB, const void *\fR\fItamp\fR\fB, size_t\fR \fItaille\fR\fB, \s-1SSL\s0 *\fR\fIssl\fR\fB, void *\fR\fIarg\fR\fB));\fR \fBvoid SSL_set_msg_callback_arg(\s-1SSL\s0 *\fR\fIssl\fR\fB, void *\fR\fIarg\fR\fB);\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBSSL_CTX_set_msg_callback\fR() ou \fBSSL_set_msg_callback\fR() peuvent être utilisées pour définir une fonction de rappel de message \fIcb\fR pour observer tous les messages de protocole \s-1SSL/TLS \s0(tels des messages d’initiation de connexion) qui sont reçus ou envoyés. \fBSSL_CTX_set_msg_callback_arg\fR() et \&\fBSSL_set_msg_callback_arg\fR() peuvent être utilisées pour définir l’argument \&\fIarg\fR de la fonction de rappel, qui est disponible pour toute application. .PP \&\fBSSL_CTX_set_msg_callback\fR() et \fBSSL_CTX_set_msg_callback_arg\fR() précisent les réglages par défaut qui seront copiés dans les nouveaux objets \s-1SSL\s0 par \&\fBSSL_new\fR(3). \fBSSL_set_msg_callback\fR() et \&\fBSSL_set_msg_callback_arg\fR() changent les réglages existants d’un objet \&\s-1SSL.\s0 L’utilisation d’un pointeur \fB0\fR pour \fIcb\fR désactive le rappel de messages. .PP Quand \fIcb\fR est appelé par la bibliothèque \s-1SSL/TLS\s0 pour un message de protocole, les arguments de la fonction ont les significations suivantes : .IP "\fIwrite_p\fR" 4 .IX Item "write_p" Cet indicateur est \fB0\fR lorsqu’un message de protocole est reçu et \fB1\fR lorsqu’un message est envoyé. .IP "\fIversion\fR" 4 .IX Item "version" La version du protocole à partir de laquelle la bibliothèque interprètera les messages de protocole. Actuellement c’est une parmi \fB\s-1SSL2_VERSION\s0\fR, \&\fB\s-1SSL3_VERSION\s0\fR et \fB\s-1TLS1_VERSION\s0\fR (pour \s-1SSL 2.0, SSL 3.0\s0 et \s-1TLS 1.0,\s0 respectivement). .IP "\fIcontent_type\fR" 4 .IX Item "content_type" Pour \s-1SSL 2.0,\s0 c’est toujours \fB0\fR. Pour \s-1SSL 3.0\s0 ou \s-1TLS 1.0,\s0 c’est une des valeurs de \fBContentType\fR définies dans les spécifications de protocole (\fBchange_cipher_spec(20)\fR, \fBalert(21)\fR, \fBhandshake(22)\fR ; mais jamais \&\fBapplication_data(23)\fR car le rappel n’est demandé que pour des messages de protocole. .IP "\fItamp\fR, \fItaille\fR" 4 .IX Item "tamp, taille" \&\fItamp\fR pointe vers un tampon contenant le message de protocole qui est constitué de \fItaille\fR octets. Le tampon n’est plus valable après que la fonction de rappel s'est terminée. .IP "\fIssl\fR" 4 .IX Item "ssl" L’objet \s-1SSL\s0 qui a reçu ou envoyé le message. .IP "\fIarg\fR" 4 .IX Item "arg" L’argument défini par l’utilisateur, facultativement défini par \&\fBSSL_CTX_set_msg_callback_arg\fR() ou \fBSSL_set_msg_callback_arg\fR(). .SH "NOTES" .IX Header "NOTES" Les messages de protocole sont transmis à la fonction de rappel après déchiffrement et l’assemblage de morceaux où c’est autorisé (les limites d’enregistrement ne sont pas visibles). .PP Si durant le processus, un message de protocole reçu conduit à une erreur, la fonction de rappel ne sera pas appelée. Par exemple, la fonction de rappel ne verra jamais les messages considérés comme trop grands pour être traités. .PP À cause de la négociation automatique de version de protocole, \fIversion\fR n’est pas inévitablement la version de protocole utilisée par l’expéditeur du message. Si un message ClientHello de \s-1TLS 1.0\s0 est reçu par un serveur uniquement \s-1SSL 3.0, \s0\fIversion\fR sera \fB\s-1SSL3_VERSION\s0\fR. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fBssl\fR(3), \fBSSL_new\fR(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" \&\fBSSL_CTX_set_msg_callback\fR(), \fBSSL_CTX_set_msg_callback_arg\fR(), \&\fBSSL_set_msg_callback\fR() et \fBSSL_get_msg_callback_arg\fR() ont été ajoutées dans OpenSSL 0.9.7. .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.