GETDOMAINNAME(3) | Library Functions Manual | GETDOMAINNAME(3) |
getdomainname
,
setdomainname
— get/set NIS
domain name of current host
Standard C Library (libc, -lc)
#include
<unistd.h>
int
getdomainname
(char
*name, int
namelen);
int
setdomainname
(const
char *name, int
namelen);
Getdomainname
()
returns the standard NIS 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 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.
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.
The following errors may be returned by these calls:
Domain names are limited to MAXHOSTNAMELEN
(from ⟨sys/param.h⟩) characters,
currently 256.
The getdomainname
() function call appeared
in 4.2BSD.
May 6, 1994 | macOS 14.6 |