1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
|
[vset VERSION 1.0.9]
[comment {-*- tcl -*- doctools manpage}]
[manpage_begin uuid n [vset VERSION]]
[keywords GUID]
[keywords UUID]
[moddesc {uuid}]
[copyright {2004, Pat Thoyts <patthoyts@users.sourceforge.net>}]
[titledesc {UUID generation and comparison}]
[category {Hashes, checksums, and encryption}]
[require Tcl "8.5 9"]
[require uuid [opt [vset VERSION]]]
[description]
[para]
This package provides a generator of universally unique identifiers
(UUID) also known as globally unique identifiers (GUID). This
implementation follows the draft specification from (1) although this
is actually an expired draft document.
[section {COMMANDS}]
[list_begin definitions]
[call [cmd "::uuid::uuid generate"]]
Creates a type 4 uuid by MD5 hashing a number of bits of variant data
including the time and hostname.
Returns the string representation of the new uuid.
[call [cmd "::uuid::uuid equal"] [arg "id1"] [arg "id2"]]
Compares two uuids and returns true if both arguments are the same uuid.
[list_end]
[section {EXAMPLES}]
[example {
% uuid::uuid generate
b12dc22c-5c36-41d2-57da-e29d0ef5839c
}]
[section {REFERENCES}]
[list_begin enumerated]
[enum]
Paul J. Leach, "UUIDs and GUIDs", February 1998.
([uri http://www.opengroup.org/dce/info/draft-leach-uuids-guids-01.txt])
[list_end]
[vset CATEGORY uuid]
[include ../common-text/feedback.inc]
[manpage_end]
|