getentropy(3)              Library Functions Manual              getentropy(3)

NOM
       getentropy - Remplir un tampon avec des octets aleatoires

BIBLIOTHEQUE
       Bibliotheque C standard (libc, -lc)

SYNOPSIS
       #include <unistd.h>

       int getentropy(void buffer[.length], size_t length);

   Exigences de macros de test de fonctionnalites pour la glibc (consulter
   feature_test_macros(7)) :

       getentropy() :
           _DEFAULT_SOURCE

DESCRIPTION
       La fonction getentropy() ecrit longueur octets de donnees a caractere
       aleatoire de haute qualite dans le tampon debutant a la position
       memoire pointee par tampon. L'argument longueur ne doit pas depasser
       256.

       En cas de succes, getentropy() genere toujours le nombre d'octets
       d'entropie demande.

VALEUR RENVOYEE
       En cas de succes, cette fonction renvoie zero. En cas d'erreur, elle
       renvoie -1 et errno est definie de facon a indiquer la nature de
       l'erreur.

ERREURS
       EFAULT Tout ou partie du tampon specifie par tampon et longueur n'est
              pas dans une zone de memoire adressable valable.

       EIO    longueur est superieure a 256.

       EIO    Une erreur inconnue est survenue en tentant d'ecraser tampon
              avec des donnees aleatoires.

       ENOSYS Cette version du noyau ne prend pas en charge l'appel systeme
              getrandom(2) necessaire a l'implementation de cette fonction.

STANDARDS
       Aucune.

HISTORIQUE
       glibc 2.25. OpenBSD.

NOTES
       La fonction getentropy() est implementee en utilisant getrandom(2).

       Alors que l'interface de la glibc fait de getrandom(2) un point
       d'annulation (cancelation point), getentropy() n'en est pas un.

       getentropy() est aussi declaree dans <sys/random.h> (il n'est pas
       necessaire de definir une macro de test de fonctionnalite pour obtenir
       la declaration a partir de ce fichier d'en-tetes).

       Un appel a getentropy() peut se bloquer si le systeme vient juste de
       demarrer et si le noyau n'a pas encore collecte assez de donnees
       aleatoires pour initialiser la reserve d'entropie. Dans ce cas,
       getentropy() restera bloque meme si un signal est envoye, et ne rendra
       la main que lorsque le jeu d'entropie aura ete initialise.

VOIR AUSSI
       getrandom(2), urandom(4), random(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org> et Lucien Gentis <lucien.gentis@waika9.com>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                  getentropy(3)