getdomainname(3) - NetBSD Manual Pages

Command: Section: Arch: Collection:  
GETDOMAINNAME(3)        NetBSD Library Functions Manual       GETDOMAINNAME(3)


NAME
getdomainname, setdomainname -- get/set domain name of current host
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <unistd.h> int getdomainname(char *name, size_t namelen); int setdomainname(const char *name, size_t namelen);
DESCRIPTION
getdomainname() returns the standard domain name for the current proces- sor, 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 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
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- tion 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 domain name and was not the super-user.
SEE ALSO
gethostid(3), gethostname(3), sysctl(3)
HISTORY
The getdomainname function call appeared in 4.2BSD.
BUGS
Domain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) charac- ters including null-termination, currently 256. NetBSD 7.1.2 May 6, 1994 NetBSD 7.1.2
Powered by man-cgi (2024-03-18). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.