getdomainname(2)                  SDK R4.11                 getdomainname(2)


NAME
       getdomainname - get name of current domain

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

   where:
       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 Network Information Services makes use of domains.

       Domain names are limited to MAXDOMAINNAMELEN characters, which is
       defined in </sys/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.

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.

SEE ALSO
       gethostid(2), gethostname(2), setdomainname(2).


Licensed material--property of copyright holder(s)