UUID_GENERATE(3)           Manualul programatorului           UUID_GENERATE(3)

NUME
       uuid_generate, uuid_generate_random, uuid_generate_time,
       uuid_generate_time_safe - creeaza o noua valoare unica UUID

REZUMAT
       #include <uuid.h>

       void uuid_generate(uuid_t out); +
       void uuid_generate_random(uuid_t out); +
       void uuid_generate_time(uuid_t out); +
       int uuid_generate_time_safe(uuid_t out); +
       void uuid_generate_md5(uuid_t out, const uuid_t ns, const char *name,
       size_t len); +
       void uuid_generate_sha1(uuid_t out, const uuid_t ns, const char *name,
       size_t len);

DESCRIERE
       Func<?>ia uuid_generate() creeaza un nou identificator unic universal
       (UUID). Uuid-ul va fi generat pe baza unui caracter aleatoriu de inalta
       calitate din getrandom(2), /dev/urandom sau /dev/random, daca este
       disponibil. Daca nu este disponibil, atunci uuid_generate() va utiliza
       un algoritm alternativ care folose<?>te ora curenta, adresa MAC a
       re<?>elei ethernet locale (daca este disponibila) <?>i date aleatoare
       generate cu ajutorul unui generator pseudo-aleator.

       Func<?>ia uuid_generate_random() for<?>eaza utilizarea formatului UUID
       complet aleatoriu, chiar daca nu este disponibil un generator de numere
       aleatorii de inalta calitate, caz in care va fi inlocuit cu un
       generator pseudo-aleatoriu. Re<?>ine<?>i ca utilizarea unui generator
       pseudo-aleatoriu poate compromite unicitatea UUID-urilor generate in
       acest mod.

       Func<?>ia uuid_generate_time() for<?>eaza utilizarea algoritmului
       alternativ care utilizeaza ora curenta <?>i adresa MAC ethernet locala
       (daca este disponibila). Acest algoritm a fost utilizat in mod implicit
       pentru generarea UUID-urilor, dar din cauza utilizarii adresei MAC
       ethernet, acesta poate furniza informa<?>ii despre momentul <?>i locul
       in care a fost generat UUID-ul. Acest lucru poate cauza probleme de
       confiden<?>ialitate in unele aplica<?>ii, astfel incat func<?>ia
       uuid_generate() utilizeaza acest algoritm numai daca nu este
       disponibila o sursa de generare de numere aleatorii de inalta calitate.
       Pentru a garanta unicitatea UUID-urilor generate de procese care
       ruleaza simultan, biblioteca uuid utilizeaza un contor global de stare
       a ceasului (daca procesul are permisiuni pentru a ob<?>ine acces
       exclusiv la acest fi<?>ier) <?>i/sau demonul uuidd(8), daca acesta
       ruleaza deja sau poate fi ini<?>iat de proces (daca este instalat <?>i
       procesul are suficiente permisiuni pentru a-l rula). In cazul in care
       niciunul dintre aceste doua mecanisme de sincronizare nu poate fi
       utilizat, este teoretic posibil ca doua procese care ruleaza simultan
       sa ob<?>ina acela<?>i UUID (UUID-uri). Pentru a afla daca UUID-ul a
       fost generat intr-un mod sigur, utiliza<?>i uuid_generate_time_safe.

       Func<?>ia uuid_generate_time_safe() este similara cu
       uuid_generate_time(), cu excep<?>ia faptului ca returneaza o valoare
       care indica daca a fost utilizat vreunul dintre mecanismele de
       sincronizare (a se vedea mai sus).

       UUID-ul are o lungime de 16 octe<?>i (128 de bi<?>i), ceea ce da
       aproximativ 3,4x10^38 valori unice (exista aproximativ 10^80 de
       particule elementare in univers, conform car<?>ii Cosmos a lui Carl
       Sagan). Noul UUID poate fi considerat in mod rezonabil unic intre toate
       UUID-urile create pe sistemul local <?>i intre UUID-urile create pe
       alte sisteme in trecut <?>i in viitor.

       Func<?>iile uuid_generate_md5() <?>i uuid_generate_sha1() genereaza un
       UUID calculat (previzibil) folosind algoritmele MD5 <?>i SHA1 pe baza
       unui UUID bine cunoscut care furnizeaza spa<?>iul de nume <?>i a unui
       <?>ir binar arbitrar. UUID-urile sunt conforme cu UUID-urile V3 <?>i V5
       conform RFC-4122 <https://tools.ietf.org/html/rfc4122>.

VALOAREA RETURNATA
       UUID-ul nou creat este returnat in loca<?>ia de memorie indicata de
       out. uuid_generate_time_safe() returneaza zero daca UUID-ul a fost
       generat intr-un mod sigur, iar in caz contrar -1.

IN CONFORMITATE CU
       Aceasta biblioteca genereaza UUID-uri compatibile cu OSF DCE 1.1 <?>i
       UUID-uri bazate pe sumele de control (hash) V3 <?>i V5 compatibile cu
       RFC-4122 <https://tools.ietf.org/html/rfc4122>.

AUTORI
       Theodore Y. Ts'o

CONSULTA<?>I <?>I
       uuidgen(1), uuid(3), uuid_clear(3), uuid_compare(3), uuid_copy(3),
       uuid_is_null(3), uuid_parse(3), uuid_time(3), uuid_unparse(3), uuidd(8)

RAPORTAREA ERORILOR
       Pentru rapoarte de eroare, folosi<?>i sistemul de urmarire al erorilor
       <https://github.com/util-linux/util-linux/issues>.

DISPONIBILITATE
       Biblioteca libuuid face parte din pachetul util-linux incepand cu
       versiunea 2.15.1. Acesta poate fi descarcat de la Linux Kernel Archive
       <https://www.kernel.org/pub/linux/utils/util-linux/>.

util-linux 2.41                   2025-03-29                  UUID_GENERATE(3)