GETHOSTID(2,L) AIX Technical Reference GETHOSTID(2,L) ------------------------------------------------------------------------------- gethostid, sethostid PURPOSE Gets or sets the unique identifier of the current Internet host. SYNTAX int gethostid ( ) int sethostid (hostid) int hostid; DESCRIPTION The gethostid system call returns the 32-bit identifier for the current host, as set by sethostid. The sethostid system call establishes a 32-bit identifier for the current host that is intended to be unique. Often, this is a DARPA Internet address for the local machine. This system call can only be used by processes with an effective user ID of superuser. RETURN VALUE Upon successful completion, the gethostid system call returns the identifier for the current host, and the sethostid system call returns a value of 0. If the gethostid or sethostid system call fails, a value of -1 is returned, and errno is set to indicate the error. ERROR CONDITIONS The gethostid or sethostid system call fails if the following is true: EINVAL There are no IP interfaces available. IBM AIX TCP/IP is not installed on this system. The sethostid system call also fails if the following is true: EPERM The calling process did not have an effective user ID of superuser. RELATED INFORMATION In this book: "getsockname." Processed November 7, 1990 GETHOSTID(2,L) 1 GETHOSTID(2,L) AIX Technical Reference GETHOSTID(2,L) The hostname command in AIX TCP/IP User's Guide. Processed November 7, 1990 GETHOSTID(2,L) 2