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)