Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo Command Reference

uuidgen - generate a Universal Unique Identifier (UUID)

uuidgen [-o filename] [{-i | -n number}] [-v] [-h] [-?]

uuidgen, by default, generates a Universal Unique Identifier (UUID) on the standard output.The UUID is used to uniquely identifier an IDL interface definition. The format for 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. (For samples of this format, see "Examples.")

The following uuidgen(1) options are supported.

-i

Produces an IDL file template, including a UUID string. (See "Examples" for samples of the file format.) This option cannot be specified with the -n option.

-n number

Generates the specified number of UUID strings. This option cannot be specified with the -i option.

-o filename

Redirects the output to the specified file.

-v

Displays the version number for uuidgen(1) but does not generate a UUID string.

-h or -?

Displays help information for uuidgen(1).

The generation of the UUID requires the availability of a 48-bit IEEE 802 address. Because this type of address is not available in all environments and the method of determination is not portable, several methods are available for use with the BEA Tuxedo system version of uuidgen.

• If the NADDR environment variable is set to a value of the form

  num.num.num.num 

  it is assumed to be an Internet-style address and converted accordingly.

• Otherwise, if the WSNADDR environment variable is set to a value of the form

  0xnnnnnnnnnnnnnnnn

  it is assumed to be a hexadecimal network address, as used in Workstation.

• Otherwise, if not DOS, the uname for the machine is used to look up the machine entry in /etc/hosts to get the Internet-style address.

• Otherwise, a warning is printed and 00.00.00.00 is used.

Note that in each of these cases, a 32-bit address is formed and the remainder of the address (for 48-bits) is treated as 00.00.

uuidgen exits with a non-zero exit code if an invalid command-line option is specified, or if it cannot open the output file. A warning is printed if an invalid network address value is given and the value 00.00.00.00 is used.

To generate a UUID string, enter the following command.

uuidgen 
23C67E00-71B6-11C9-9DFC-08002B0ECEF1

To generate an IDL template for developing an interface definition, enter the following command.

uuidgen -i  
[uuid(B5F8DB80-3CCA-14F8-1E78-930269370000)]  
interface INTERFACE  
{  
}

To generate two UUID strings, enter the following command.

uuidgen -n 2  
C0B37080-3CCA-14F8-265F-930269370000
C0B37081-3CCA-14F8-2CDB-930269370000

tidl(1)