getdomainname(2)getdomainname(2)NAME
getdomainname, setdomainname - get/set name of current NIS domain
SYNOPSIS
int getdomainname(char *name, int namelen);
int setdomainname(char *name, int namelen);
DESCRIPTION
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.
RETURN VALUE
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
variable errno.
ERRORS
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
to setdomainname.
BUGS
NIS domain names are limited to 64 characters.
NOTE
This call is provided for backward compatibility with pre-IRIX 5.0
applications.
Page 1
