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 that may be used by application programs. It
is usually set to the primary Internet address of the local machine, represented as a network standard byte order integer.
The sethostid() function fails if the calling process does not have superuser 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
Commands: hostid(1).
Functions: gethostid(2), gethostname(2). delim off
sethostid(2)