Scroll to navigation

UUID_GENERATE(3) API de libuuid UUID_GENERATE(3)

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.

mai 2009 util-linux