NAME

uuidgen - Generates a Universal Unique Identifier (UUID)

SYNOPSIS

uuidgen [argument] ...

Arguments

−cAllows you to supply an existing UUID that uuidgen then outputs in the format you specify.  This option is especially useful in combination with the -s option for converting an existing UUID into a C structure.  You must specify the -c option at the end of the uuidgen command line; all options that follow -c are ignored. 

−iProduces an Interface Definition Language (IDL) file template and includes the generated UUID string in the template. 

−o filename
Redirects the generated UUID string to the file you specify.

−sGenerates a UUID string as an initialized C structure. 

−vDisplays the version number of the UUID generator, but does not generate a UUID. 

−hDisplays information about the uuidgen command arguments. The arguments −h and −? can be used interchangeably. 

−?Displays information about the uuidgen command arguments. The arguments −? and −h can be used interchangeably. 

−n number_of_uuid_strings
Generates a specified number of UUID strings.

DESCRIPTION

The uuidgen command creates a UUID string that you assign to an object to uniquely identify it. One such use is in the UUID interface attribute of an IDL interface definition.  The format for representing a UUID string consists of eight hexadecimal digits followed by a dash, followed by three groups of four hexadecimal digits separated by dashes, followed by a dash and twelve hexadecimal digits:

01234567-89ab-cdef-0123-456789abcdef

FILES

The locations of files have the following pathnames:

dceshared/bin/uuidgenGenerator

dceshared/nls/msg/LANG/uuidgen.catGenerator error messages

EXAMPLES

     1.Generate a UUID string:

$ uuidgen

23c67e00-71b6-11c9-9dfc-08002b0ecef1

     2.Generate a partial template, containing a generated UUID string, to be used to develop an interface definition:

$ uuidgen -i

[
uuid(828bf780-71b6-11c9-b5a8-08002b0ecef1),
version (1.0)
]
interface INTERFACENAME
{
 }

     3.Convert a UUID string from the old−style format to the new format:

$ uuidgen -t 34DC23469EAF.AB.A2.01.7C.5F.2C.ED.A3

34dc2346-9eaf-0000-aba2-017c5f2ceda3

     4.Generate four UUID strings:

$ uuidgen -n 4

612c0b00-71b8-11c9-973a-08002b0ecef1
612c0b01-71b8-11c9-973a-08002b0ecef1
612c0b02-71b8-11c9-973a-08002b0ecef1
612c0b03-71b8-11c9-973a-08002b0ecef1

     5.Convert a UUID into a C structure:

$ uuidgen -s -c 1251ace6-93al-11cd-95ad-0800097086e4

= { /* 1251ace6-93al-11cd-95ad-0800097086e4 */
0x1251ace6,
0x93al,
0x11cd,
0x95,
0xad
{0x08, 0x00, 0x09, 0x70, 0x86, 0xe4}
};

Hewlett-Packard Company  —  OSF DCE 1.1/HP DCE 1.5