setdomainname(2) [osf1 man page]

getdomainname(2)						System Calls Manual						  getdomainname(2)

NAME

       getdomainname, setdomainname - get or set name of current domain

SYNOPSIS

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

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

DESCRIPTION

       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 hav-
       ing 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

       Domain names are limited to 64 characters.

RETURN VALUES

       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

       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)

Check Out this Related Man Page

GETDOMAINNAME(3)					   BSD Library Functions Manual 					  GETDOMAINNAME(3)

NAME

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

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <unistd.h>

     int
     getdomainname(char *name, int namelen);

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

DESCRIPTION

     The getdomainname() function returns the standard NIS domain name for the current host, as previously set by setdomainname().  The namelen
     argument specifies the size of the name array.  The returned name is null-terminated unless insufficient space is provided.

     The setdomainname() function sets the NIS domain name of the host machine to be name, which has length namelen.  This call is restricted to
     the super-user and is normally used only when the system is bootstrapped.

RETURN VALUES

     Upon successful completion, the value 0 is returned; otherwise the value -1 is returned and the global variable errno is set to indicate the
     error.

ERRORS

     The following errors may be returned by these calls:

     [EFAULT]		The name or namelen argument gave an invalid address.

     [EPERM]		The caller tried to set the hostname and was not the super-user.

SEE ALSO

     gethostid(3), gethostname(3), sysctl(3)

HISTORY

     The getdomainname() function appeared in 4.2BSD.

BUGS

     Domain names are limited to MAXHOSTNAMELEN (from <sys/param.h>) characters, currently 256.

BSD
								    May 6, 1994 							       BSD

Linux and UNIX Man Pages

setdomainname(2) [osf1 man page]

Check Out this Related Man Page