getdomainname(2) getdomainname(2)
NAME
getdomainname, setdomainname - get/set name of current
domain
SYNOPSIS
getdomainname(name, namelen)
char *name;
int namelen;
setdomainname(name, namelen)
char *name;
int namelen;
DESCRIPTION
getdomainname returns the name of the domain for the current
processor, 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.
setdomainname sets the domain of the host machine to be
name, which has length namelen. This call is restricted to
the super-user and is normally used only when the system is
bootstrapped.
The purpose of domains is to enable two distinct networks
that may have host names 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.
RETURN VALUE
If the call succeeds a value of 0 is returned. If the call
fails, then a value of -1 is returned and an error code is
placed in the global location errno.
ERRORS
The following errors may be returned by these calls:
[EFAULT] The name or namelen parameter gave an invalid
address.
[EPERM] The caller was not the super-user.
BUGS
Domain names are limited to 255 characters.
Page 1 (last mod. 1/14/87)