getdomainname(2)           DG/UX 4.30            getdomainname(2)



     NAME
          getdomainname - Get name of current domain.

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

     PARAMETERS
          name           Buffer to receive domain name.


          namelen        Buffer length in bytes.

     DESCRIPTION
          Getdomainname returns the name of the network domain of the
          host system, as previously set by setdomainname. The
          parameter namelen specifies the size of the name array. The
          returned name is null-terminated unless insufficient space
          is provided.

          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>.

          Calling getdomainname before calling setdomainname produces
          undefined results.

     ACCESS CONTROL
          None.

     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.

     SEE ALSO



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

     getdomainname(2)           DG/UX 4.30            getdomainname(2)



          The related manual sections:  gethostid(2), gethostname(2),
          setdomainname(2).





















































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