sethostid(2)                   DG/UX R4.11MU05                  sethostid(2)


NAME
       sethostid - set unique identifier of current host

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

   where:
       newhostid     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 capdefaults(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
       appropriateprivilege(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),
       appropriateprivilege(5).
       capdefaults(5).


Licensed material--property of copyright holder(s)