1
2[//000000001]: # (uuid \- uuid)
3[//000000002]: # (Generated from file 'uuid\.man' by tcllib/doctools with format 'markdown')
4[//000000003]: # (Copyright &copy; 2004, Pat Thoyts <patthoyts@users\.sourceforge\.net>)
5[//000000004]: # (uuid\(n\) 1\.0\.6 tcllib "uuid")
6
7<hr> [ <a href="../../../../toc.md">Main Table Of Contents</a> &#124; <a
8href="../../../toc.md">Table Of Contents</a> &#124; <a
9href="../../../../index.md">Keyword Index</a> &#124; <a
10href="../../../../toc0.md">Categories</a> &#124; <a
11href="../../../../toc1.md">Modules</a> &#124; <a
12href="../../../../toc2.md">Applications</a> ] <hr>
13
14# NAME
15
16uuid \- UUID generation and comparison
17
18# <a name='toc'></a>Table Of Contents
19
20  - [Table Of Contents](#toc)
21
22  - [Synopsis](#synopsis)
23
24  - [Description](#section1)
25
26  - [COMMANDS](#section2)
27
28  - [EXAMPLES](#section3)
29
30  - [REFERENCES](#section4)
31
32  - [Bugs, Ideas, Feedback](#section5)
33
34  - [Keywords](#keywords)
35
36  - [Category](#category)
37
38  - [Copyright](#copyright)
39
40# <a name='synopsis'></a>SYNOPSIS
41
42package require Tcl 8\.5
43package require uuid ?1\.0\.6?
44
45[__::uuid::uuid generate__](#1)
46[__::uuid::uuid equal__ *id1* *id2*](#2)
47
48# <a name='description'></a>DESCRIPTION
49
50This package provides a generator of universally unique identifiers \(UUID\) also
51known as globally unique identifiers \(GUID\)\. This implementation follows the
52draft specification from \(1\) although this is actually an expired draft
53document\.
54
55# <a name='section2'></a>COMMANDS
56
57  - <a name='1'></a>__::uuid::uuid generate__
58
59    Creates a type 4 uuid by MD5 hashing a number of bits of variant data
60    including the time and hostname\. Returns the string representation of the
61    new uuid\.
62
63  - <a name='2'></a>__::uuid::uuid equal__ *id1* *id2*
64
65    Compares two uuids and returns true if both arguments are the same uuid\.
66
67# <a name='section3'></a>EXAMPLES
68
69    % uuid::uuid generate
70    b12dc22c-5c36-41d2-57da-e29d0ef5839c
71
72# <a name='section4'></a>REFERENCES
73
74  1. Paul J\. Leach, "UUIDs and GUIDs", February 1998\.
75     \([http://www\.opengroup\.org/dce/info/draft\-leach\-uuids\-guids\-01\.txt](http://www\.opengroup\.org/dce/info/draft\-leach\-uuids\-guids\-01\.txt)\)
76
77# <a name='section5'></a>Bugs, Ideas, Feedback
78
79This document, and the package it describes, will undoubtedly contain bugs and
80other problems\. Please report such in the category *uuid* of the [Tcllib
81Trackers](http://core\.tcl\.tk/tcllib/reportlist)\. Please also report any ideas
82for enhancements you may have for either package and/or documentation\.
83
84When proposing code changes, please provide *unified diffs*, i\.e the output of
85__diff \-u__\.
86
87Note further that *attachments* are strongly preferred over inlined patches\.
88Attachments can be made by going to the __Edit__ form of the ticket
89immediately after its creation, and then using the left\-most button in the
90secondary navigation bar\.
91
92# <a name='keywords'></a>KEYWORDS
93
94[GUID](\.\./\.\./\.\./\.\./index\.md\#guid), [UUID](\.\./\.\./\.\./\.\./index\.md\#uuid)
95
96# <a name='category'></a>CATEGORY
97
98Hashes, checksums, and encryption
99
100# <a name='copyright'></a>COPYRIGHT
101
102Copyright &copy; 2004, Pat Thoyts <patthoyts@users\.sourceforge\.net>
103