gethostuuid(2) Mac OS X Developer Tools Manual Page

Mac Dev Center Mac OS X Reference Library General Mac OS X Man Pages

This manual page is part of Xcode Tools version 3.2.2

To obtain these tools:

Install the Xcode Tools from developer.apple.com.

If you are running a version of Xcode Tools other than 3.2.2, view the documentation locally:

In Xcode
In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

For more information about the manual page format, see the manual page for manpages(5).
For more information about this technology, look for other documentation in the Apple Reference Library.
For general information about writing shell scripts, read Shell Scripting Primer.


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

NAME
     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 cur-rent current
     rent machine.  Be aware that the hardware 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

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors: Report errors in the content of this documentation with the feedback links below.
Bug reports: Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems: Report formatting mistakes in the online version of these pages with the feedback links below.

Did this document help you?