Manual browser: setdomainname(3)
|GETDOMAINNAME(3)||Library Functions Manual||GETDOMAINNAME(3)|
NAMEgetdomainname, setdomainname — get/set domain name of current host
LIBRARYStandard C Library (libc, -lc)
getdomainname(char *name, size_t namelen);
setdomainname(const char *name, size_t namelen);
DESCRIPTIONgetdomainname() returns the standard domain name 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 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 VALUESIf 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 location errno.
ERRORSThe following errors may be returned by these calls:
- The name or namelen parameter gave an invalid address.
- The caller tried to set the domain name and was not the super-user.
HISTORYThe getdomainname function call appeared in 4.2BSD.
BUGSDomain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters including null-termination, currently 256.
|May 6, 1994||NetBSD 7.0|