sethostid(2)                      SDK R4.11                     sethostid(2)


NAME
       sethostid - set unique identifier of current host

SYNOPSIS
       #include <unistd.h>
       int   sethostid (new_hostid)
       long  new_hostid;

   where:
       new_hostid     Hostid to set

DESCRIPTION
       Sethostid establishes an identifier for the current node, which is
       intended to be unique among all UNIX systems in existence.  This is
       normally a DARPA Internet address for the local machine.  The calling
       process must have appropriate privilege to successfully execute this
       call; it is normally performed at boot time.

ACCESS CONTROL
       The calling process must have appropriate privilege to successfully
       execute this system call.  For systems supporting the DG/UX
       Capability Option, appropriate privilege is defined as having one or
       more specific capabilities enabled in the effective capability set of
       the calling process.  See cap_defaults(5) for the default capability
       for this system call.

       On systems without the DG/UX Capability Option, appropriate privilege
       means that the process has an effective UID of root.  See the
       appropriate_privilege(5) man page for more information.

RETURN VALUE
       0      Completed successfully.

       -1     An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to the following error code:

       EPERM     The calling process must have appropriate privilege.

SEE ALSO
       hostid(1C), getdomainname(2), gethostid(2), gethostname(2),
       appropriate_privilege(5).
       cap_defaults(5).


Licensed material--property of copyright holder(s)