NUME¶

getrandom - obține o serie de octeți aleatorii

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <sys/random.h>

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

DESCRIERE¶

Apelul de sistem getrandom() umple memoria tampon indicată de buf cu până la buflen octeți aleatorii. Acești octeți pot fi utilizați pentru însămânțarea generatoarelor de numere aleatorii din spațiul utilizatorului sau în scopuri criptografice.

În mod implicit, getrandom() extrage entropia din sursa urandom (adică aceeași sursă ca dispozitivul /dev/urandom). Acest comportament poate fi modificat prin intermediul argumentului flags.

Dacă sursa urandom a fost inițializată, citirile de până la 256 de octeți vor returna întotdeauna numărul de octeți solicitat și nu vor fi întrerupte de semnale. Nu se aplică astfel de garanții pentru dimensiuni mai mari ale memoriei tampon. De exemplu, dacă apelul este întrerupt de un gestionar de semnal, acesta poate returna un tampon parțial umplut sau poate eșua cu eroarea EINTR.

Dacă sursa urandom nu a fost încă inițializată, atunci getrandom() se va bloca, cu excepția cazului în care GRND_NONBLOCK este specificat în flags.

Argumentul flags este o mască de biți care poate conține zero sau mai multe dintre următoarele valori unite împreună printr-un operator SAU logic:

GRND_RANDOM

Dacă acest bit este activat, atunci octeții aleatorii sunt extrași din sursa random (adică aceeași sursă ca dispozitivul /dev/random) în locul sursei urandom. Sursa random este limitată pe baza entropiei care poate fi obținută din zgomotul ambiental. Dacă numărul de octeți disponibili în sursa random este mai mic decât cel solicitat în buflen, apelul returnează doar octeții aleatori disponibili. Dacă nu sunt disponibili octeți aleatorii, comportamentul depinde de prezența GRND_NONBLOCK în argumentul flags.

GRND_NONBLOCK

În mod implicit, atunci când citește din sursa random, getrandom() se blochează dacă nu sunt disponibili octeți aleatori, iar atunci când citește din sursa urandom, se blochează dacă fondul de entropie nu a fost încă inițializat. Dacă fanionul GRND_NONBLOCK este activat, atunci getrandom() nu se blochează în aceste cazuri, ci returnează imediat -1 cu errno configurată la EAGAIN.

VALOAREA RETURNATö

În caz de succes, getrandom() returnează numărul de octeți care au fost copiați în memoria tampon buf. Acesta poate fi mai mic decât numărul de octeți solicitat prin buflen dacă fie GRND_RANDOM a fost specificat în flags și entropia a fost insuficientă în sursa random, fie apelul sistemului a fost întrerupt de un semnal.

În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI-IEȘIRE¶

EAGAIN

Entropia solicitată nu a fost disponibilă, iar getrandom() s-ar fi blocat dacă flagul GRND_NONBLOCK nu era activat.

EFAULT

Adresa menționată de buf se află în afara spațiului de adrese accesibil.

EINTR

Apelul a fost întrerupt de un gestionar de semnal; consultați descrierea modului în care apelurile read(2) întrerupte pe dispozitive „lente” sunt gestionate cu și fără fanionul SA_RESTART în pagina de manual signal(7).

EINVAL

În flags a fost specificat un fanion nevalid.

ENOSYS

Funcția de învăluire a glibc pentru getrandom() a determinat că nucleul subiacent nu implementează acest apel de sistem.

STANDARDE¶

Linux.

ISTORIC¶

Linux 3.17, glibc 2.25.

NOTE¶

Pentru o prezentare generală și o comparație a diverselor interfețe care pot fi utilizate pentru a obține caracterul aleatoriu, a se vedea random(7).

tătăSpre deosebire de /dev/random și /dev/urandom, getrandom() nu implică utilizarea numelor de rută sau a descriptorilor de fișiere. Astfel, getrandom() poate fi util în cazurile în care chroot(2) face invizibile numele de rută /dev și în care o aplicație (de exemplu, un demon în timpul lansării) închide un descriptor de fișier pentru unul dintre aceste fișiere care a fost deschis de o bibliotecă.

ERORI¶

Începând cu Linux 3.19, există următoarea eroare:

•

În funcție de sarcina CPU, getrandom() nu reacționează la întreruperi înainte de a citi toți octeții solicitați.

CONSULTAȚI ȘI¶

getentropy(3), random(4), urandom(4), random(7), signal(7)

TRADUCERE¶

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.