- NetBSD Manual Pages
GETDOMAINNAME(3) NetBSD Library Functions Manual GETDOMAINNAME(3)
Powered by man-cgi (2020-09-24).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
getdomainname, setdomainname -- get/set domain name of current host
Standard C Library (libc, -lc)
getdomainname(char *name, size_t namelen);
setdomainname(const char *name, size_t namelen);
getdomainname() returns the standard domain name for the current host, 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 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.
If the call succeeds a value of 0 is returned. If the call fails, a
value of -1 is returned and an error code is placed in the global loca-
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 domain name and was not
gethostid(3), gethostname(3), sysctl(3)
The getdomainname function call appeared in 4.2BSD.
Domain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) charac-
ters including null-termination, currently 256.
NetBSD 9.99 May 6, 1994 NetBSD 9.99