Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gethostuuid(2) [osx man page]

GETHOSTUUID(2)						   Mac OS X System Calls Manual 					    GETHOSTUUID(2)

gethostuuid -- return a unique identifier for the current machine SYNOPSIS
#include <unistd.h> int gethostuuid(uuid_t id, const struct timespec *wait); DESCRIPTION
The gethostuuid() function returns a 16-byte uuid_t specified by id, that uniquely identifies the current machine. Be aware that the hard- ware identifiers that gethostuuid() uses to generate the UUID can themselves be modified. The wait argument is a pointer to a struct timespec that specifies the maximum time to wait for the result. Setting the tv_sec and tv_nsec fields to zero means to wait indefinitely until it completes. RETURN VALUES
The gethostuuid() function returns zero on success or -1 on error. ERRORS
The gethostuuid() functions fails if: [EFAULT] wait points to memory that is not a valid part of the process address space. [EWOULDBLOCK] The wait timeout expired before the UUID could be obtained. SEE ALSO
uuid(3) Mac OS X Nov 5, 2008 Mac OS X

Check Out this Related Man Page

UUID(3) 						   BSD Library Functions Manual 						   UUID(3)

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
Standard C Library (libc, -lc) SYNOPSIS
#include <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. BSD
March 1, 2012 BSD
Man Page