.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2017, Michael Kerrisk .\" .\" %%%LICENSE_START(VERBATIM) .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of .\" this manual under the conditions for verbatim copying, provided that .\" the entire resulting derived work is distributed under the terms of .\" a permission notice identical to this one. .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume. .\" no responsibility for errors or omissions, or for damages resulting. .\" from the use of the information contained herein. The author(s) may. .\" not have taken the same level of care in the production of this. .\" manual, which is licensed free of charge, as they might when working. .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH GETENTROPY 3 "15 septembre 2017" Linux "Manuel du programmeur Linux" .SH NOM getentropy \- Remplir un tampon avec des octets aléatoires .SH SYNOPSIS \fB#include \fP .PP \fBint getentropy(void *\fP\fItampon\fP\fB, size_t \fP\fIlongueur\fP\fB);\fP .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBgetentropy\fP()\ : .br .RS 4 .ad l _DEFAULT_SOURCE .RE .ad .SH DESCRIPTION La fonction \fBgetentropy\fP() écrit \fIlongueur\fP octets de données à caractère aléatoire de haute qualité dans le tampon débutant à la position mémoire pointée par \fItampon\fP. L'argument \fIlongueur\fP ne doit pas dépasser 256. .PP En cas de succès, \fBgetentropy\fP() génère toujours le nombre d'octets d'entropie demandé. .SH "VALEUR RENVOYÉE" En cas de succès, cette fonction renvoie zéro. En cas d'erreur, elle renvoie \fB\-1\fP et \fIerrno\fP est définie de façon à indiquer la nature de l'erreur. .SH ERREURS .TP \fBEFAULT\fP Tout ou partie du tampon spécifié par \fItampon\fP et \fIlongueur\fP n'est pas dans une zone de mémoire adressable valable. .TP \fBEIO\fP \fIlongueur\fP est supérieure à 256. .TP \fBEIO\fP Une erreur inconnue est survenue en tentant d'écraser \fItampon\fP avec des données aléatoires. .TP \fBENOSYS\fP Cette version du noyau ne prend pas en charge l'appel système \fBgetrandom\fP(2) nécessaire à l'implémentation de cette fonction. .SH VERSIONS La fonction \fBgetentropy\fP() a été introduite dans la version\ 2.25 de la glibc. .SH CONFORMITÉ Cette fonction n'est pas normalisée. Elle est aussi présente dans OpenBSD. .SH NOTES La fonction \fBgetentropy\fP() est implémentée en utilisant \fBgetrandom\fP(2). .PP Alors que l'interface de la glibc fait de \fBgetrandom\fP(2) un point d'annulation (cancellation point), \fBgetentropy\fP() n'en est pas un. .PP \fBgetentropy\fP() est aussi déclarée dans \fB\fP (il n'est pas nécessaire de définir une macro de test de fonctionnalité pour obtenir la déclaration à partir de ce fichier d'en\-têtes). .PP Un appel à \fBgetentropy\fP() peut se bloquer si le système vient juste de démarrer et si le noyau n'a pas encore collecté assez de données aléatoires pour initialiser la réserve d'entropie. Dans ce cas, \fBgetentropy\fP() restera bloqué même si un signal est envoyé, et ne rendra la main que lorsque le jeu d'entropie aura été initialisé. .SH "VOIR AUSSI" \fBgetrandom\fP(2), \fBurandom\fP(4), \fBrandom\fP(7) .SH COLOPHON Cette page fait partie de la publication\ 5.10 du projet \fIman\-pages\fP Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man\-pages/. .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot et Lucien Gentis . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .