NAME    [Toc]    [Back]

       sethostid - Set the unique identifier of the current host

SYNOPSIS    [Toc]    [Back]

       int sethostid(
               int host_id );

PARAMETERS    [Toc]    [Back]

       Specifies  the  unique  32-bit  identifier for the current
       host.

DESCRIPTION    [Toc]    [Back]

       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 the superuser privilege.

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

       If the sethostid() function fails, errno may be set to the
       following value: The calling process  does  not  have  the
       appropriate privilege.

SEE ALSO    [Toc]    [Back]

       Commands: hostid(1).

       Functions: gethostid(2), gethostname(2).



                                                     sethostid(2)