NAME

uuid  — A dcecp object that generates and compares UUIDs

SYNOPSIS

uuid compare uuid uuid

uuid create

uuid help  [operation | verbose  ]

uuid operations

Arguments

uuidA UUID in the following form:

C069d9fb6-943e-11cd-a35c-0000c08adf56 

operationThe 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. 

Errors

A representative list of errors that might be returned is not shown here.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

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

verboseDisplays 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(8dce), endpoint(8dce).