NAME    [Toc]    [Back]

     uuid_compare, uuid_create, uuid_create_nil, uuid_equal, uuid_from_string,
     uuid_hash, uuid_is_nil, uuid_to_string -- DCE 1.1 compliant UUID functions

LIBRARY    [Toc]    [Back]

     Standard C Library (libc, -lc)

SYNOPSIS    [Toc]    [Back]

     #include <uuid.h>

     int32_t
     uuid_compare(uuid_t *uuid1, uuid_t *uuid2, uint32_t *status);

     void
     uuid_create(uuid_t *uuid, uint32_t *status);

     void
     uuid_create_nil(uuid_t *uuid, uint32_t *status);

     int32_t
     uuid_equal(uuid_t *uuid1, uuid_t *uuid2, uint32_t *status);

     void
     uuid_from_string(const char *str, uuid_t *uuid, uint32_t *status);

     uint16_t
     uuid_hash(uuid_t *uuid, uint32_t *status);

     int32_t
     uuid_is_nil(uuid_t *uuid, uint32_t *status);

     void
     uuid_to_string(uuid_t *uuid, char **str, uint32_t *status);

DESCRIPTION    [Toc]    [Back]

     The family of DCE 1.1 compliant UUID functions allow applications to
     operate on universally unique identifiers, or UUIDs.  The uuid_create()
     and uuid_create_nil() functions create UUIDs.  The uuid_compare(),
     uuid_equal() and uuid_is_nil() functions can be used to test UUIDs.  To
     convert from the binary representation to the string representation or
     vice versa, use uuid_to_string() or uuid_from_string() respectively.  A
     16-bit hash value can be obtained by calling uuid_hash().

RETURN VALUES    [Toc]    [Back]

     The successful or unsuccessful completion of the function is returned in
     the status argument.  Possible values are:

     uuid_s_ok			 The function completed successfully.

     uuid_s_bad_version 	 The UUID does not have a known version.

     uuid_s_invalid_string_uuid  The string representation of an UUID is not
				 valid.

     uuid_s_no_memory		 The meaning of the code escaped the writers
				 mind.

SEE ALSO    [Toc]    [Back]

     uuidgen(1), uuidgen(2)

BUGS    [Toc]    [Back]

     This manpage can be improved.

STANDARDS    [Toc]    [Back]

     The UUID functions conform to the DCE 1.1 RPC specification.


FreeBSD 5.2.1		       October 29, 2002 		 FreeBSD 5.2.1