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().
The
uuid_to_string()
function set
*str
to be a pointer to a buffer sufficiently large to hold the string.
This pointer should be passed to
free(3)
to release the allocated storage when it is no longer needed.
The
uuid_enc_le()
and
uuid_enc_be()
functions encode a binary representation of a UUID into an octet stream
in little-endian and big-endian byte-order, respectively.
The destination buffer must be pre-allocated by the caller, and must be
large enough to hold the 16-octet binary UUID.
These routines are not part of the DCE RPC API.
They are provided for convenience.
The
uuid_dec_le()
and
uuid_dec_be()
functions decode a UUID from an octet stream in little-endian and
big-endian byte-order, respectively.
These routines are not part of the DCE RPC API.
They are provided for convenience.
