getentropy(3) Library Functions Manual getentropy(3)
NOM
getentropy - Remplir un tampon avec des octets aléatoires
BIBLIOTHÈQUE
Bibliothèque C standard (libc, -lc)
SYNOPSIS
#include <unistd.h>
int getentropy(void buffer[.length], size_t length);
Exigences de macros de test de fonctionnalités pour la glibc (consulter
feature_test_macros(7)) :
getentropy() :
_DEFAULT_SOURCE
DESCRIPTION
La fonction getentropy() écrit longueur octets de données à caractère
aléatoire de haute qualité dans le tampon débutant à la position mé-
moire pointée par tampon. L'argument longueur ne doit pas dépasser 256.
En cas de succès, getentropy() génère toujours le nombre d'octets d'en-
tropie demandé.
VALEUR RENVOYÉE
En cas de succès, cette fonction renvoie zéro. En cas d'erreur, elle
renvoie -1 et errno est définie de façon à indiquer la nature de l'er-
reur.
ERREURS
EFAULT Tout ou partie du tampon spécifié par tampon et longueur n'est
pas dans une zone de mémoire adressable valable.
EIO longueur est supérieure à 256.
EIO Une erreur inconnue est survenue en tentant d'écraser tampon
avec des données aléatoires.
ENOSYS Cette version du noyau ne prend pas en charge l'appel système
getrandom(2) nécessaire à l'implémentation de cette fonction.
VERSIONS
La fonction getentropy() a été introduite dans la version 2.25 de la
glibc.
STANDARDS
Cette fonction n'est pas normalisée. Elle est aussi présente dans
OpenBSD.
NOTES
La fonction getentropy() est implémentée en utilisant getrandom(2).
Alors que l'interface de la glibc fait de getrandom(2) un point d'annu-
lation (cancelation point), getentropy() n'en est pas un.
getentropy() est aussi déclarée dans <sys/random.h> (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).
Un appel à getentropy() 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éa-
toires pour initialiser la réserve d'entropie. Dans ce cas, geten-
tropy() restera bloqué même si un signal est envoyé, et ne rendra la
main que lorsque le jeu d'entropie aura été initialisé.
VOIR AUSSI
getrandom(2), urandom(4), random(7)
TRADUCTION
La traduction française de cette page de manuel a été créée par Chris-
tophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <ste-
phan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, Fran-
çois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Gué-
rard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.cou-
lon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux
<thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centra-
liens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <si-
mon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@de-
bian.org>, David Prévot <david@tilapin.org> et Lucien Gentis <lu-
cien.gentis@waika9.com>
Cette traduction est une documentation libre ; veuillez vous reporter à
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 RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à ⟨debian-l10n-french@lists.debian.org⟩.
Pages du manuel de Linux 6.03 10 novembre 2022 getentropy(3)
Generated by dwww version 1.15 on Sat Jun 29 01:37:11 CEST 2024.