GETDOMAINNAME(3) BSD Programmer's Manual GETDOMAINNAME(3)NAME
getdomainname, setdomainname - get/set name of current host
SYNOPSIS
#include <unistd.h>
int
getdomainname(char *name, int namelen);
int
setdomainname(const char *name, int namelen);
DESCRIPTIONGetdomainname() returns the standard host name for the current processor,
as previously set by setdomainname(). The namelen argument specifies the
size of the name array. The returned name is null-terminated unless in-
sufficient space is provided.
Setdomainname() sets the name of the host machine to be name, which has
length namelen. This call is restricted to the super-user and is normally
used when the system is bootstrapped.
NOTA BENE
The YP/NIS (formerly ``Yellow Pages'' but renamed for legal reasons) do-
main name does not necessarily have anything to do with the Domain Name
System domain name, although they are often set equal for administrative
convenience.
RETURN VALUES
If the call succeeds a value of 0 is returned. If the call fails, a val-
ue 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 tried to set the domainname and was not the su-
per-user.
SEE ALSOdomainname(1), sysctl(3)BSDI BSD/OS March 10, 1991 1
