Manual Page Result
0
Command: sethostid | Section: 2 | Source: Digital UNIX | File: sethostid.2.gz
sethostid(2) System Calls Manual sethostid(2)
NAME
sethostid - Sets the unique identifier of the current host
SYNOPSIS
int sethostid ( int host_id );
PARAMETERS
Specifies the unique 32-bit identifier for the current host.
DESCRIPTION
The sethostid() function allows a calling process with a root user ID
to set a new 32-bit identifier for the current host. The sethostid()
function enables an application program to reset the host ID. The host
ID is a unique number which may be used by application programs. It is
usually set to the primary IP address of the local machine.
The sethostid() function fails if the calling process does not have su-
peruser privilege.
RETURN VALUES
Upon successful completion, the sethostid() function returns a value of
0 (zero). If the sethostid() function fails, a value of -1 is returned
and errno is set to indicate the error.
ERRORS
If the sethostid() function fails, errno may be set to the following
value: The calling process does not have the appropriate privilege.
RELATED INFORMATION
Functions: gethostid(2), gethostname(2) delim off
sethostid(2)