NAME    [Toc]    [Back]

       getdomainname,  setdomainname - get or set name of current
       domain

SYNOPSIS    [Toc]    [Back]

       getdomainname(name, namelen)
               char *name;
               int namelen;

       setdomainname(name, namelen)
               char *name;
               int namelen;

DESCRIPTION    [Toc]    [Back]

       The getdomainname system call returns the domain  name  of
       the current host, as set by setdomainname.

       The  setdomainname system call sets the domain of the host
       machine to be name, which has a length specified by  namelen.
  This  system call is restricted to the superuser and
       is normally used only when the system is bootstrapped.

       The purpose of domains is to allow merging of two distinct
       networks that have common host names.  Each network can be
       distinguished by having a different domain name.   At  the
       current  time,  only the Network Information Service (NIS)
       makes use of domains.

       The name argument is the address where  the  name  of  the
       current domain is stored.

       The namelen argument specifies the size of the name array.
       The returned name is null-terminated  unless  insufficient
       space is provided.

RESTRICTIONS    [Toc]    [Back]

       Domain names are limited to 64 characters.

RETURN VALUES    [Toc]    [Back]

       If  the  call  succeeds, a value of 0 is returned.  If the
       call fails, a value of -1 is returned and an error code is
       placed in the global location, errno.

ERRORS    [Toc]    [Back]

       The  name  parameter  contains  an  invalid  address.  The
       caller was not the superuser.   This  error  message  only
       applies to the setdomainname system call.



                                                 getdomainname(2)