sethostname(2)             DG/UX 4.30              sethostname(2)



     NAME
          sethostname - Set name of current host.

     SYNOPSIS
          int   sethostname  (name, namelen)
          char *          name;
          int             namelen;

     PARAMETERS
          name           Name to set for host.


          namelen        Length of name in bytes.

     DESCRIPTION
          Sethostname sets the name of the host node to <name>, which
          has length <namelen>.  Only the superuser may use this call;
          it is normally used at boot time.

          Hostnames are limited to MAXHOSTNAMELEN characters, which is
          defined in <sys/param.h>.

     ACCESS CONTROL
          Only the superuser can set the hostname.

     RETURN VALUE
          0              Completed successfully.


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

     EXCEPTIONS
          Errno may be set to one of the following error codes:


          EFAULT         The <name> parameter gave an invalid address,
                         or the <namelen> parameter specified a length
                         less than zero.


          EPERM          The caller was not the superuser.

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









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