getdomainname(2)
_________________________________________________________________
getdomainname System Call
Get name of current domain.
_________________________________________________________________
SYNTAX
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
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
getdomainname(2)
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
The related manual sections: gethostid(2), gethostname(2),
setdomainname(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)