GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  UUID_CREATE_NIL (3)

NAME

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

CONTENTS

Library
Synopsis
Description
Return Values
See Also
Standards
Bugs

LIBRARY


.Lb libc

SYNOPSIS


.In uuid.h int32_t uuid_compare const uuid_t *uuid1 const 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 const uuid_t *uuid1 const uuid_t *uuid2 uint32_t *status void uuid_from_string const char *str uuid_t *uuid uint32_t *status uint16_t uuid_hash const uuid_t *uuid uint32_t *status int32_t uuid_is_nil const uuid_t *uuid uint32_t *status void uuid_to_string const uuid_t *uuid char **str uint32_t *status void uuid_enc_le void *buf const uuid_t *uuid void uuid_dec_le const void *buf uuid_t * void uuid_enc_be void *buf const uuid_t *uuid void uuid_dec_be const void *buf uuid_t *

DESCRIPTION

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.

RETURN VALUES

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 function can not allocate memory to store an UUID representation.

SEE ALSO

uuidgen(1), uuidgen(2)

STANDARDS

The UUID functions conform to the DCE 1.1 RPC specification.

BUGS

This manpage can be improved.
Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.