sethostid(2)sethostid(2)NAMEsethostid - Set 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, rep‐
resented as a network standard byte order integer.
The sethostid() function fails if the calling process does not have the
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.
SEE ALSO
Commands: hostid(1).
Functions: gethostid(2), gethostname(2).
sethostid(2)