NOM

       random_r, srandom_r, initstate_r, setstate_r - Générateur de nombres aléatoires réentrant

SYNOPSIS

       #include <stdlib.h>

       int random_r(struct random_data *buf, int32_t *result);

       int srandom_r(unsigned int seed, struct random_data *buf);

       int initstate_r(unsigned int seed, char *statebuf,
                       size_t statelen, struct random_data *buf);
       int setstate_r(char *statebuf, struct random_data *buf);

   Exigences    de    macros    de   test   de   fonctionnalités   pour   la   glibc   (consultez
   feature_test_macros(7)) :

       random_r(), srandom_r(), initstate_r(), setstate_r() :
           _SVID_SOURCE || _BSD_SOURCE

DESCRIPTION

       Ces fonctions sont les équivalents réentrants des fonctions décrites dans random(3). Elles
       sont  appropriées  à l'utilisation dans des programmes multithreadés où chaque thread doit
       pouvoir obtenir une séquence indépendante et reproductible de nombres aléatoires.

       La  fonction  random_r()  est  identique  à  random(3),  excepté  qu'au  lieu   d'utiliser
       l'information  d'état  maintenue  dans  une  variable  globale, elle utilise l'information
       d'état située dans l'argument pointé par buf. Le nombre aléatoire généré est renvoyé  dans
       l'argument result.

       La  fonction  srandom_r() est identique à srandom(3), excepté qu'elle initialise la graine
       du générateur de nombre aléatoire dont l'état est maintenu dans l'objet pointé par buf, au
       lieu de la graine associée à la variable d'état globale.

       La  fonction  initstate_r() est identique à initstate(3) excepté qu'elle initialise l'état
       dans l'objet pointé par buf, plutôt que d'initialiser la variable d'état globale.

       La fonction setstate_r() est identique à setstate(3) excepté qu'elle modifie  l'état  dans
       l'objet pointé par buf, plutôt que de modifier la variable d'état globale.

VALEUR RENVOYÉE

       Toutes  ces  fonctions  renvoient  0  en cas de succès. En cas d'erreur, -1 est renvoyé et
       errno contient le code de l'erreur.

ERREURS

       EINVAL Une table d'états de moins de 8 octets a été fournie à initstate_r().

       EINVAL Le paramètre statebuf ou buf de setstate_r() était NULL.

       EINVAL Le paramètre buf ou result de random_r() était NULL.

ATTRIBUTS

   Multithreading (voir pthreads(7))
       Les fonctions random_r(), srandom_r(), initstate_r() et setstate_r() sont  sûres  dans  un
       contexte multithread.

CONFORMITÉ

       Ces fonctions sont des extensions non standard de la glibc.

VOIR AUSSI

       drand48(3), rand(3), random(3)

COLOPHON

       Cette  page  fait partie de la publication 3.65 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Nicolas  François  et  l'équipe  francophone  de traduction de Debian (2006-2009). Nicolas
       François et l'équipe francophone de traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>   ou   par   un  rapport  de  bogue  sur  le  paquet
       manpages-fr.

       Vous pouvez toujours avoir accès à la version anglaise de  ce  document  en  utilisant  la
       commande « man -L C <section> <page_de_man> ».