.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" 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" '' '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. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" ======================================================================== .\" .IX Title "fr::crypto::RAND_add 3SSL" .TH fr::crypto::RAND_add 3SSL "2013-02-26" "1.0.1e" "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" RAND_add, RAND_seed, RAND_status, RAND_event, RAND_screen \- Ajouter de l'entropie au générateur de nombres pseudoaléatoires .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& #include \& \& void RAND_seed(const void *buf, int num); \& \& void RAND_add(const void *buf, int num, double entropy); \& \& int RAND_status(void); \& \& int RAND_event(UINT iMsg, WPARAM wParam, LPARAM lParam); \& void RAND_screen(void); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBRAND_add\fR() mélange les \fInum\fR octets de \fIbuf\fR dans l'état du générateur de nombres pseudoaléatoires. Ainsi, si les données de \fIbuf\fR sont imprévisibles pour un adversaire, cela augmente l'incertitude sur l'état et rend la sortie du générateur de nombres pseudoaléatoires moins prévisible. L'entrée adéquate provient des interactions de l'utilisateur (frappes de touches aléatoires, mouvements de la souris) et de certains événements dans le matériel. L'argument \fIentropy\fR est (la limite basse d')une estimation de la quantité de hasard contenu dans \fIbuf\fR, en octet. Des précisions sur les sources de l'aléa et la façon d'estimer leur entropie sont disponibles dans la littérature, par exemple la \s-1RFC\s0 1750. .PP \&\fBRAND_add\fR() pourrait être appelée avec des données sensibles comme des mots de passe entrés par l'utilisateur. Les valeurs d'initialisation ne peuvent pas être récupérées depuis la sortie du générateur de nombres pseudoaléatoires. .PP OpenSSL s'assure que l'état de générateur de nombres pseudoaléatoires est unique pour chaque thread. Sur les systèmes qui fournissent \f(CW\*(C`/dev/urandom\*(C'\fR, le périphérique de hasard est utilisé pour initialiser le générateur de nombres pseudoaléatoires de façon transparente. Cependant, sur tous les autres systèmes, l'application est responsable de l'initialisation du générateur de nombres pseudoaléatoires en appelant \fBRAND_add\fR(), \&\fIRAND_egd\fR\|(3) ou \fIRAND_load_file\fR\|(3). .PP \&\fBRAND_seed\fR() est équivalent à \fBRAND_add\fR() quand \fBnum == entropy\fR. .PP \&\fBRAND_event\fR() collecte l'entropie des événement de Windows comme les mouvements de la souris et autres interactions de l'utilisateur. Elle devrait être appelée avec les arguments \fIiMsg\fR, \fIwParam\fR et \fIlParam\fR de \&\fItous\fR les messages envoyés à la procédure de Windows. Elle estimera l'entropie contenue dans le message (s'il y en a) et l'ajoutera au générateur de nombres pseudoaléatoires, le programme peut ensuite traiter les messages comme d'habitude. .PP La fonction \fBRAND_screen\fR() est disponible pour faciliter le travail des programmeurs sous Windows. Elle ajoute le contenu actuel de l'écran au générateur de nombres pseudoaléatoires. Pour les applications qui attrapent les événements de Windows, l'initialisation du générateur de nombres pseudoaléatoires en appelant \fBRAND_event\fR() est une source de hasard significativement meilleure. Remarquez que ces deux méthodes ne peuvent pas être utilisées sur les serveurs qui fonctionnent sans interaction de l'utilisateur. .SH "VALEURS DE RETOUR" .IX Header "VALEURS DE RETOUR" \&\fBRAND_status\fR() et \fBRAND_event\fR() renvoient \fB1\fR si le générateur de nombres pseudoaléatoires a été initialisé avec suffisamment de données, \fB0\fR sinon. .PP Les autres fonctions ne renvoient pas de valeur. .SH "VOIR AUSSI" .IX Header "VOIR AUSSI" \&\fIrand\fR\|(3), \fIRAND_egd\fR\|(3), \&\fIRAND_load_file\fR\|(3), \fIRAND_cleanup\fR\|(3) .SH "HISTORIQUE" .IX Header "HISTORIQUE" \&\fBRAND_seed\fR() et \fBRAND_screen\fR() sont disponibles dans toutes les versions de SSLeay et OpenSSL. \fBRAND_add\fR() et \fBRAND_status\fR() ont été ajoutées dans OpenSSL 0.9.5, \fBRAND_event\fR() dans OpenSSL 0.9.5a. .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.