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.