uuid_gen Command (NCS)

Purpose

Generates Universal Unique Identifiers (UUIDs) for objects, types, and interfaces.

Syntax

/etc/ncs/uuid_gen-c ] [  -p ] [  -C ] [  -P ]

Description

The uuid_gen program generates Universal Unique Identifiers (UUIDs). By default, it generates a character-string representation of a UUID. The options for uuid_gen enable you to generate source-code representations of UUIDs, suitable for initializing variables of type uuid_$t.

Flags

Item Description
-C Generates a C source-code representation of a UUID.
-c Generates a template, including a UUID attribute, for an interface definition in the C syntax.
-P Generates a Pascal source-code representation of a UUID.
-p Generates a template, including a UUID attribute, for an interface definition in the Pascal syntax.

Examples

  1. To generate a character-string representation of a UUID, enter the following:
    /etc/ncs/uuid_gen
    This produces the following output:
    34dc23469000.0d.00.00.7c.5f.00.00.00
      
  2. To generate a template for an interface definition in the C syntax, enter:
    /etc/ncs/uuid_gen -c
    This produces the following output:
    %c
    [
    uuid(34dc239ec000.0d.00.00.7c.5f.00.00.00),
    version(1)
    ]
    interface INTERFACENAME {
     
    }
  3. To generate a C source-code representation of a UUID, enter the following:
    /etc/ncs/uuid_gen -C
    This produces the following output:
    = { 0x34dc23af,
        0xf000,
        0x0000,
        0x0d,
        {0x00, 0x00, 0x7c, 0x5f, 0x00, 0x00, 0x00} };
  4. To generate a template for an interface definition in the Pascal syntax, enter the following:
    /etc/ncs/uuid_gen -p
    This produces the following output:
    %pascal
    [
    uuid (458487b55160.02.c0.64.02.03.00.00.00),
    version (1)
    ]
    interface INTERFACENAME;
     
    end;
  5. To generate a Pascal source-code representation of a UUID, enter the following:
    /etc/ncs/uuid_gen -P
    This produces the following output:
    := [
        time_high := 16#458487df,
        time_low := 16#9fb2,
        reserved := 16#000,
        family := chr(16#02),
        host := [chr(16#c0), chr(16#64), chr(16#02), chr(16#03),
                 chr(16#00), chr(16#00), chr(16#00)]
        ]