NOM

       uuid_generate,  uuid_generate_random,  uuid_generate_time,  uuid_generate_time_safe  - Créer une nouvelle
       valeur d'UUID

SYNOPSIS

       #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);

DESCRIPTION

       La fonction uuid_generate crée un nouvel identifiant unique universel (UUID). L'uuid sera  généré  en  se
       basant  sur  la  haute  qualité  aléatoire de /dev/urandom, s'il est disponible. S'il ne l'est pas, alors
       uuid_generate utilisera un autre algorithme qui utilise l'heure actuelle, l'adresse MAC  Ethernet  locale
       (si disponible) et une donnée aléatoire générée par un générateur pseudoaléatoire.

       La fonction uuid_generate_random impose l'utilisation d'UUID totalement aléatoires, même si le générateur
       haute  qualité  de  nombres  aléatoires  (c'est-à-dire, /dev/urandom) n'est pas disponible, auquel cas un
       générateur pseudoaléatoire lui sera substitué. À noter que l'utilisation  du  générateur  pseudoaléatoire
       peut compromettre l'unicité des UUID générés de cette façon.

       La  fonction  uuid_generate_time  impose  l'utilisation  de  l'algorithme  alternatif qui utilise l'heure
       actuelle et l'adresse MAC Ethernet locale (si disponible). Cet algorithme était celui utilisé par  défaut
       pour  générer  les  UUID,  mais à cause de l'utilisation de l'adresse MAC Ethernet, il peut divulguer des
       informations sur quand et où l'UUID a été créé. Cela peut poser des  problèmes  de  confidentialité  dans
       certaines  applications, donc la fonction uuid_generate utilise cet algorithme seulement si aucune source
       de génération aléatoire et de haute qualité n'est disponible. Pour garantir l'unicité  des  UUID  générés
       par  les  processus exécutés en même temps, la bibliothèque uuid utilise un compteur d'état d'horloge (si
       le processus est autorisé à obtenir un accès exclusif à ce fichier) ou le démon uuidd, s'il est  déjà  en
       cours  d'exécution  ou  peut  être  engendré  par le processus (s'il est installé et que le processus est
       autorisé à l'exécuter). Si aucun de ces deux mécanismes de synchronisation ne peut être utilisé,  il  est
       théoriquement  possible  que deux processus exécutés en même temps obtiennent les mêmes UUID. Pour savoir
       si l'UUID a été généré de façon sûre, utilisez uuid_generate_time_safe.

       uuid_generate_time_safe est similaire à uuid_generate_time si ce n'est qu'elle  renvoie  une  valeur  qui
       indique si un des mécanismes de synchronisation (voir ci-dessus) a été utilisé.

       L'UUID  est  long de 16 octets (128 bits), ce qui donne environ 3,4x10^38 valeurs uniques (il y a environ
       10^80 particules élémentaires dans l'univers d'après le Cosmos de Carl Sagan). Le nouvel UUID  peut  être
       raisonnablement  considéré  comme  unique  parmi tous les UUID créés localement sur le système, ainsi que
       parmi les UUID créés sur d'autres systèmes par le passé et dans le futur.

VALEUR DE RETOUR

       Le nouveau UUID créé est renvoyé dans  l'emplacement  mémoire  pointé  par  out.  uuid_generate_time_safe
       renvoie zéro si l'UUID a été généré de façon sûre, -1 sinon.

CONFORMITÉ

       OSF DCE 1.1

AUTEUR

       Theodore Y. Ts'o

DISPONIBILITÉ

       libuuid   fait   partie   du  paquet  util-linux  depuis  la  version 2.15.1,  elle  est  disponible  sur
       <ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/>.

VOIR AUSSI

       uuid(3),   uuidgen(1),   uuidd(8),   uuid_clear(3),   uuid_compare(3),   uuid_copy(3),   uuid_is_null(3),
       uuid_parse(3), uuid_time(3), uuid_unparse(3)

TRADUCTION

       La  traduction  de  cette page de manuel est maintenue par les membres de la liste <debian-l10n-french AT
       lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de  bogue  sur  le
       paquet manpages-fr-extra.

util-linux                                          mai 2009                                    UUID_GENERATE(3)