uuid(n) [mojave man page]

uuid(n) 							       uuid								   uuid(n)

__________________________________________________________________________________________________________________________________________________

NAME

       uuid - UUID generation and comparison

SYNOPSIS

       package require Tcl  8.2

       package require uuid  ?1.0.1?

       ::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 implemen-
       tation 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 represen-
	      tation 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 SF Trackers [http://sourceforge.net/tracker/?group_id=12883].  Please also report any ideas for enhancements you  may  have  for
       either package and/or documentation.

KEYWORDS

       GUID, UUID

CATEGORY

       Hashes, checksums, and encryption

COPYRIGHT

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

uuid								       1.0.1								   uuid(n)

uuid(1m)																  uuid(1m)

NAME

       uuid - A dcecp object that generates and compares UUIDs

SYNOPSIS

       uuid compare uuid uuid

       uuid create

       uuid help [operation | -verbose]

       uuid operations

ARGUMENTS

       A UUID in the following form: C069d9fb6-943e-11cd-a35c-0000c08adf56 The name of the uuid operation for which to display help information.

DESCRIPTION

       The  uuid object generates and compares Universal Unique Identifiers (UUIDs).  UUIDs uniquely identify DCE entities such as principals, RPC
       entries, Cell Directory Service (CDS) replicas, and so on.

OPERATIONS

   uuid compare
       Compares two UUIDs.  The syntax is as follows: uuid compare uuid uuid

       The compare operation compares two UUIDs, returning 1 if they are equal or 0 if they are not.  Because the uuid compare command handles the
       comparison of UUIDs in current and previous DCE formats, you should use it rather than string compare.

       Privileges Required

       No special privileges are needed to use the uuid compare command.

       Examples

       dcecp> uuid compare 03bb2688-943e-11cd-8bfd-0000c08adf56  > 069d9fb6-943e-11cd-a35c-0000c08adf56 0 dcecp>

   uuid create
       Returns a newly generated UUID.	The syntax is as follows: uuid create

       The create operation returns a newly generated UUID.  It takes no arguments.

       Privileges Required

       No special privileges are needed to use the uuid create command.

       Examples

       dcecp> uuid create 03bb2688-943e-11cd-8bfd-0000c08adf56 dcecp>

   uuid help
       Returns help information about the uuid object and its operations.  The syntax is as follows: uuid help [operation | -verbose]

       Options Displays information about the uuid object.

       Used  without  an  argument  or	option, the uuid help command returns brief information about each uuid operation.  The optional operation
       argument is the name of an operation about which you want detailed information.	Alternatively, you can use the -verbose  option  for  more
       detailed information about the uuid object itself.

       Privileges Required

       No special privileges are needed to use the uuid help command.

       Examples

       dcecp>  uuid  help  compare		Compares  two  UUIDs  for  equality.   create		    Returns  a newly generated UUID.  help
       Prints a summary of command-line options.  operations	      Returns a list of the valid operations for this command.	dcecp>

   uuid operations
       Returns a list of the operations supported by the uuid object.  The syntax is as follows: uuid operations

       The list of available operations is in alphabetical order except for help and operations, which are listed last.

       Privileges Required

       No special privileges are needed to use the uuid operations command.

       Examples

       dcecp> uuid operations compare create help operations dcecp>

RELATED INFORMATION

       Commands: dcecp(1m).

																	  uuid(1m)