sethostid(2)               DG/UX 4.30                sethostid(2)



     NAME
          sethostid - Set unique identifier of current host.

     SYNOPSIS
          int   sethostid  (new_hostid)
          long            new_hostid;

     PARAMETERS
          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.  Only the superuser may use this call; it
          is normally performed at boot time.

     ACCESS CONTROL
          The effective user id of the calling process must be
          superuser.

     RETURN VALUE
          0              Completed successfully.


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

     EXCEPTIONS
          Errno may be set to the following error code:


          EPERM          Caller must be superuser.

     SEE ALSO
          The related manual sections:  hostid(1), gethostid(2),
          getdomainname(2), gethostname(2).


















     Licensed material--property of copyright holder(s)         Page 1