setdomainname(2)
_________________________________________________________________
setdomainname System Call
Set name of current domain.
_________________________________________________________________
SYNTAX
int setdomainname (name, namelen)
char * name;
int namelen;
PARAMETERS
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>. Only the superuser may use this call; it
is normally used at boot time.
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 the superuser can set the domain name.
RETURN VALUE
0 Completed successfully.
-1 An error occurred. Errno is set to indicate the
error.
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
setdomainname(2)
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.
EPERM The caller was not the superuser.
SEE ALSO
The related manual sections: gethostname(2), gethostid(2),
getdomainname(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)