getrandom(2)                  System Calls Manual                 getrandom(2)

NUME
       getrandom - ob<?>ine o serie de octe<?>i aleatorii

BIBLIOTECA
       Biblioteca C standard (libc, -lc)

SINOPSIS
       #include <sys/random.h>

       ssize_t getrandom(size_t buflen;
                         void buf[buflen], size_t buflen, unsigned int flags);

DESCRIERE
       Apelul de sistem getrandom() umple memoria tampon indicata de buf cu
       pana la buflen octe<?>i aleatorii. Ace<?>ti octe<?>i pot fi utiliza<?>i
       pentru insaman<?>area generatoarelor de numere aleatorii din spa<?>iul
       utilizatorului sau in scopuri criptografice.

       In mod implicit, getrandom() extrage entropia din sursa urandom (adica
       aceea<?>i sursa ca dispozitivul /dev/urandom). Acest comportament poate
       fi modificat prin intermediul argumentului flags.

       Daca sursa urandom a fost ini<?>ializata, citirile de pana la 256 de
       octe<?>i vor returna intotdeauna numarul de octe<?>i solicitat <?>i nu
       vor fi intrerupte de semnale.  Nu se aplica astfel de garan<?>ii pentru
       dimensiuni mai mari ale memoriei tampon. De exemplu, daca apelul este
       intrerupt de un gestionar de semnal, acesta poate returna un tampon
       par<?>ial umplut sau poate e<?>ua cu eroarea EINTR.

       Daca sursa urandom nu a fost inca ini<?>ializata, atunci getrandom() se
       va bloca, cu excep<?>ia cazului in care GRND_NONBLOCK este specificat
       in flags.

       Argumentul flags este o masca de bi<?>i care poate con<?>ine zero sau
       mai multe dintre urmatoarele valori unite impreuna printr-un operator
       SAU logic:

       GRND_RANDOM
              Daca acest bit este activat, atunci octe<?>ii aleatorii sunt
              extra<?>i din sursa random (adica aceea<?>i sursa ca
              dispozitivul /dev/random) in locul sursei urandom. Sursa random
              este limitata pe baza entropiei care poate fi ob<?>inuta din
              zgomotul ambiental. Daca numarul de octe<?>i disponibili in
              sursa random este mai mic decat cel solicitat in buflen, apelul
              returneaza doar octe<?>ii aleatori disponibili.  Daca nu sunt
              disponibili octe<?>i aleatorii, comportamentul depinde de
              prezen<?>a GRND_NONBLOCK in argumentul flags.

       GRND_NONBLOCK
              In mod implicit, atunci cand cite<?>te din sursa random,
              getrandom() se blocheaza daca nu sunt disponibili octe<?>i
              aleatori, iar atunci cand cite<?>te din sursa urandom, se
              blocheaza daca fondul de entropie nu a fost inca ini<?>ializat.
              Daca fanionul GRND_NONBLOCK este activat, atunci getrandom() nu
              se blocheaza in aceste cazuri, ci returneaza imediat -1 cu errno
              configurata la EAGAIN.

VALOAREA RETURNATA
       In caz de succes, getrandom() returneaza numarul de octe<?>i care au
       fost copia<?>i in memoria tampon buf. Acesta poate fi mai mic decat
       numarul de octe<?>i solicitat prin buflen daca fie GRND_RANDOM a fost
       specificat in flags <?>i entropia a fost insuficienta in sursa random,
       fie apelul sistemului a fost intrerupt de un semnal.

       In caz de eroare, se returneaza -1, iar errno este configurata pentru a
       indica eroarea.

ERORI-IE<?>IRE
       EAGAIN Entropia solicitata nu a fost disponibila, iar getrandom() s-ar
              fi blocat daca flagul GRND_NONBLOCK nu era activat.

       EFAULT Adresa men<?>ionata de buf se afla in afara spa<?>iului de
              adrese accesibil.

       EINTR  Apelul a fost intrerupt de un gestionar de semnal; consulta<?>i
              descrierea modului in care apelurile read(2) intrerupte pe
              dispozitive ,,lente" sunt gestionate cu <?>i fara fanionul
              SA_RESTART in pagina de manual signal(7).

       EINVAL In flags a fost specificat un fanion nevalid.

       ENOSYS Func<?>ia de invaluire a glibc pentru getrandom() a determinat
              ca nucleul subiacent nu implementeaza acest apel de sistem.

STANDARDE
       Linux.

ISTORIC
       Linux 3.17, glibc 2.25.

NOTE
       Pentru o prezentare generala <?>i o compara<?>ie a diverselor
       interfe<?>e care pot fi utilizate pentru a ob<?>ine caracterul
       aleatoriu, a se vedea random(7).

       tataSpre deosebire de /dev/random <?>i /dev/urandom, getrandom() nu
       implica utilizarea numelor de ruta sau a descriptorilor de fi<?>iere.
       Astfel, getrandom() poate fi util in cazurile in care chroot(2) face
       invizibile numele de ruta /dev <?>i in care o aplica<?>ie (de exemplu,
       un demon in timpul lansarii) inchide un descriptor de fi<?>ier pentru
       unul dintre aceste fi<?>iere care a fost deschis de o biblioteca.

   Numarul maxim de octe<?>i returna<?>i
       Incepand cu Linux 3.19 se aplica urmatoarele limite:

       o  La citirea din sursa urandom, un singur apel la getrandom()
          returneaza maximum 32Mi-1 octe<?>i pe sistemele in care int are o
          dimensiune de 32 de bi<?>i.

       o  La citirea din sursa random, se returneaza un maxim de 512 octe<?>i.

   Intreruperea de catre un gestionar de semnal
       La citirea din sursa urandom (GRND_RANDOM nu este activat), getrandom()
       se va bloca pana cand fondul de entropie a fost ini<?>ializat (cu
       excep<?>ia cazului in care a fost specificat fanionul GRND_NONBLOCK).
       Daca se solicita citirea unui numar mare de octe<?>i (mai mult de 256),
       getrandom() se va bloca pana cand ace<?>ti octe<?>i au fost genera<?>i
       <?>i transfera<?>i din memoria nucleului in buf.  Atunci cand se
       cite<?>te din sursa random (GRND_RANDOM este activat), getrandom() se
       va bloca pana cand unii octe<?>i aleatori devin disponibili (cu
       excep<?>ia cazului in care a fost specificat fanionul GRND_NONBLOCK).

       Comportamentul atunci cand un apel la getrandom() care este blocat in
       timp ce cite<?>te din sursa urandom este intrerupt de un gestionar de
       semnal depinde de starea de ini<?>ializare a tamponului de entropie
       <?>i de dimensiunea cererii, buflen. Daca entropia nu este inca
       ini<?>ializata, atunci apelul e<?>ueaza cu eroarea EINTR. Daca fondul
       de entropie a fost ini<?>ializat <?>i dimensiunea cererii este mare
       (buflen > 256), apelul fie reu<?>e<?>te, returnand un tampon par<?>ial
       umplut, fie e<?>ueaza cu eroarea EINTR. Daca fondul de entropie a fost
       ini<?>ializat <?>i dimensiunea cererii este mica (buflen <= 256),
       atunci getrandom() nu va e<?>ua cu EINTR. In schimb, va returna to<?>i
       octe<?>ii care au fost solicita<?>i.

       La citirea din sursa random, cererile de blocare de orice dimensiune
       pot fi intrerupte de un gestionar de semnal (apelul e<?>ueaza cu
       eroarea EINTR).

       Utilizarea getrandom() pentru a citi tampoane mici (<= 256 bytes) din
       sursa urandom este modul preferat de utilizare.

       Tratamentul special al valorilor mici ale buflen a fost conceput pentru
       compatibilitate cu getentropy(3) de la OpenBSD, care este in prezent
       acceptat de glibc.

       Utilizatorul aplica<?>iei getrandom() trebuie sa verifice intotdeauna
       valoarea returnata, pentru a determina daca s-a produs o eroare sau
       daca s-au returnat mai pu<?>ini octe<?>i decat s-a solicitat. In cazul
       in care GRND_RANDOM nu este specificat <?>i buflen este mai mic sau
       egal cu 256, o returnare de mai pu<?>ini octe<?>i decat s-a solicitat
       nu ar trebui sa se intample niciodata, dar programatorul atent va
       verifica acest lucru oricum!

ERORI
       Incepand cu Linux 3.19, exista urmatoarea eroare:

       o  In func<?>ie de sarcina CPU, getrandom() nu reac<?>ioneaza la
          intreruperi inainte de a citi to<?>i octe<?>ii solicita<?>i.

CONSULTA<?>I <?>I
       getentropy(3), random(4), urandom(4), random(7), signal(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.15   28 iunie 2025                    getrandom(2)