1 2[//000000001]: # (uuid \- uuid) 3[//000000002]: # (Generated from file 'uuid\.man' by tcllib/doctools with format 'markdown') 4[//000000003]: # (Copyright © 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> | <a 8href="../../../toc.md">Table Of Contents</a> | <a 9href="../../../../index.md">Keyword Index</a> | <a 10href="../../../../toc0.md">Categories</a> | <a 11href="../../../../toc1.md">Modules</a> | <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 © 2004, Pat Thoyts <patthoyts@users\.sourceforge\.net> 103