getdomainname, setdomainname - get/set name of current NIS domain
int getdomainname(char *name, int namelen);
int setdomainname(char *name, int namelen);
Getdomainname returns the name of the NIS domain 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 of the host to be name, which has
length namelen. This call is restricted to the superuser and is normally
used only during system initialization.
The purpose of NIS domains is to enable two distinct networks that may
have hostnames in common to merge. Each network would be distinguished
by having a different NIS domain name.
If the call succeeds a value of 0 is returned. If the call fails, then a
value of -1 is returned and an error code is placed in the global
The following errors may be returned by these calls:
[EFAULT] The name parameter gave an invalid address.
[EPERM] The caller was not the superuser. This error only applies
NIS domain names are limited to 64 characters.
This call is provided for backward compatibility with pre-IRIX 5.0
PPPPaaaaggggeeee 1111 [ Back ]