Man page - getentropy(3)

Packages contains this manual

Available languages:

en fr pl ru ro

Manual

getentropy

NOM
BIBLIOTHÈQUE
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
STANDARDS
HISTORIQUE
NOTES
VOIR AUSSI
TRADUCTION

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’entropie 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’erreur.

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.

STANDARDS

Aucune.

HISTORIQUE

glibc 2.25. 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’annulation (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Ă©atoires pour initialiser la rĂ©serve d’entropie. Dans ce cas, getentropy () 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 Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.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.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Lucien Gentis <lucien.gentis@waika9.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 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 .