unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 uuidgen(1)		  Open Software Foundation		  uuidgen(1)




 NAME
      uuidgen - Generates a Universal Unique Identifier (UUID)

 SYNOPSIS
      uuidgen [argument] ...


 Arguments
      -c
	Allows 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.

      -i
	Produces 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.

      -s
	Generates a UUID string as an initialized C structure.

      -v
	Displays the version number of the UUID generator, but does not
	generate a UUID.

      -h
	Displays 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.

      -l lan_card_instance
	Generates UUID using the hardware address of specified lan card
	instance ,In case of multiple lan interfaces for a host.You can use
	lanscan to get the card instance of  the lancards.








 Hewlett-Packard Company	    - 1 -	      OSF DCE 1.1/HP DCE 1.8






 uuidgen(1)		  Open Software Foundation		  uuidgen(1)




 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/uuidgen
			  Generator

      dceshared/nls/msg/LANG/uuidgen.cat
			  Generator 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



 Hewlett-Packard Company	    - 2 -	      OSF DCE 1.1/HP DCE 1.8






 uuidgen(1)		  Open Software Foundation		  uuidgen(1)




       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}
		   };


       6.  To generate UUID using the hardware address of lancard, whose
	   instance number is 1 .

	    uuidgen -l 1

	   5f393fde-a9db-11d1-9caf-080009306cc2
























 Hewlett-Packard Company	    - 3 -	      OSF DCE 1.1/HP DCE 1.8