getdomainname(2)					      getdomainname(2)

NAME    [Toc]    [Back]

     getdomainname, setdomainname - get/set name of current NIS	domain

SYNOPSIS    [Toc]    [Back]

     int getdomainname(char *name, int namelen);

     int setdomainname(char *name, int namelen);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     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    [Toc]    [Back]

     NIS domain	names are limited to 64	characters.

NOTE    [Toc]    [Back]

     This call is provided for backward	compatibility with pre-IRIX 5.0
     applications.


									PPPPaaaaggggeeee 1111