sethostname(2)                    SDK R4.11                   sethostname(2)


NAME
       sethostname - set name of current host

SYNOPSIS
       #include <unistd.h>
       int  sethostname (name, namelen)
       char * name;
       int  namelen;

   where:
       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.  The calling process must have appropriate privilege to
       successfully execute this call; it is normally used at boot time.

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

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 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 calling process did not have appropriate privilege.

SEE ALSO
       getdomainname(2), gethostid(2), gethostname(2).  uname(1), uname(2),
       appropriateprivilege(5).
       capdefaults(5).

NOTES
       This system call also modifies the node name that is contained in the
       system's utsname structure.  Subsequent calls to uname -n will return
       this new node name.


Licensed material--property of copyright holder(s)