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


NAME
       setdomainname - set name of current domain

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

   where:
       name      Name to set for domain

       namelen   Length of name in bytes

DESCRIPTION
       Setdomainname sets the domain 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.
       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.

       The purpose of domains is to enable two distinct networks that may
       have hostnames in common to merge.  Each network would be
       distinguished by having a different domain name.  At the current
       time, only the Yellow Pages service makes use of domains.

       Domain names are limited to MAXDOMAINNAMELEN characters, which is
       defined in <user/param.h>.

ACCESS CONTROL
       Only a calling process with appropriate privilege can set the domain
       name.

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


Licensed material--property of copyright holder(s)