getdomainname(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(2) System Calls Manual getdomainname(2) NAME
getdomainname, setdomainname - get or set name of current Network Information Service domain SYNOPSIS
DESCRIPTION
returns the name of the Network Information Service (NIS) domain for the current processor, as previously set by The parameter namelen specifies the size of the name array. The returned value is null-terminated unless the area pointed to by name is not large enough to hold the domain name plus the null byte. In this case, only the namelen number of bytes is returned. sets the domain of the host machine to name, which has a length of namelen. This call is restricted to the superuser and is normally used only when the system is booted. These Network Information Service domains enable two distinct networks with common host names to merge. Each network is distinguished by having a different domain name. Currently, only the Network Information Service uses these domains. RETURN VALUE
If the call succeeds, a value of 0 is returned. If the call fails, a value of -1 is returned and is set to indicate the error. ERRORS
If or fail, is set to one of the following values: name points outside the accessible address space. The caller is not superuser. This error only applies to WARNINGS
The length of the name array should be at least 65; NIS domain names can be up to 64 characters long. NIS servers use the NIS domain name as the name of a subdirectory of Since the NIS domain name can be as long as 64 characters, the domain name set with can exceed the maximum file name length allowed on the local file system. If that length is exceeded, the name of the subdi- rectory is the truncated NIS domain name. AUTHOR
getdomainname was developed by Sun Microsystems, Inc. SEE ALSO
domainname(1), ypserv(1M), ypfiles(4). getdomainname(2)