---
name: "uuid"
section: "3tcl"
platform: "linux"
package: "tcllib"
version: "2.0+dfsg-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/uuid/3tcl"
---

# uuid(3tcl)

UUID generation and comparison

```

```

## NAME

uuid - UUID generation and comparison

## SYNOPSIS

package require **Tcl 8.5 9**

package require **uuid ?1.0.9?**

**::uuid::uuid generate**

**::uuid::uuid equal** *id1* *id2*

```

```

## DESCRIPTION

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.

## COMMANDS

- **::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.

- **::uuid::uuid equal** *id1* *id2*

  Compares two uuids and returns true if both arguments are the same uuid.

## EXAMPLES

```
% uuid::uuid generate
b12dc22c-5c36-41d2-57da-e29d0ef5839c
```

## REFERENCES

- \[1\]

  Paul J. Leach, "UUIDs and GUIDs", February 1998. (*http://www.opengroup.org/dce/info/draft-leach-uuids-guids-01.txt*)

## BUGS, IDEAS, FEEDBACK

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such in the category *uuid* of the *Tcllib Trackers* \[http://core.tcl.tk/tcllib/reportlist\]. Please also report any ideas for enhancements you may have for either package and/or documentation.

When proposing code changes, please provide *unified diffs*, i.e the output of **diff -u**.

Note further that *attachments* are strongly preferred over inlined patches. Attachments can be made by going to the **Edit** form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar.

## KEYWORDS

GUID, UUID

## CATEGORY

Hashes, checksums, and encryption

## COPYRIGHT

```
Copyright (c) 2004, Pat Thoyts <patthoyts@users.sourceforge.net>
```