getdomainname(3) BSD Library Functions Manual getdomainname(3)
NAME
getdomainname, setdomainname -- get/set NIS domain name of current host
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <unistd.h>
int
getdomainname(char *name, int namelen);
int
setdomainname(const char *name, int namelen);
DESCRIPTION
Getdomainname() returns the standard NIS domain name for the current
host, as previously set by setdomainname(). The parameter namelen speci-
fies the size of the name array. The returned name is null-terminated
unless insufficient space is provided.
Setdomainname() sets the NIS domain name 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.
RETURN VALUES
Upon successful completion, the value 0 is returned; otherwise the
value -1 is returned and the global variable errno is set to indicate the
error.
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 hostname and was not the
super-user.
SEE ALSO
gethostid(3), gethostname(3), sysctl(3)
BUGS
Domain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) charac-
ters, currently 256.
HISTORY
The getdomainname() function call appeared in 4.2BSD.
BSD May 6, 1994 BSD
Mac OS X 10.8 - Generated Mon Aug 27 18:50:34 CDT 2012