HP-UX Reference (11i v1 00/12) - 2 System Calls (vol 5)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

101

102

103

104

105

106

107

108

109

110

__________________________________________________________________________________________________________________________________________________________________________________________________

STANDARD Printed by: Nora Chuang [nchuang] STANDARD

/build/1111/BRICK/man2/!!!intro.2

________________________________________________________________

___ ___

getdomainname(2) getdomainname(2)

NAME

getdomainname, setdomainname - get/set name of current Network Information Service domain

SYNOPSIS

int getdomainname(char *name, int namelen);

int setdomainname(char *name, int namelen);

DESCRIPTION

getdomainname() returns the name of the Network Information Service (NIS) domain for the current

processor, as previously set by setdomainname(). The parameter namelen speciﬁes 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.

setdomainname() 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

errno is set to

indicate the error.

ERRORS

getdomainname() or setdomainname()

fail, errno is set to one of the following values:

[EFAULT] name points outside the accessible address space.

[EPERM] The caller is not superuser. This error only applies to setdomainname()

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

/var/yp. Since the NIS domain

name can be as long as 64 characters, the domain name set with

setdomainname()

can exceed the

maximum ﬁle name length allowed on the local ﬁle system. If that length is exceeded, the name of the sub-

directory is the truncated NIS domain name.

AUTHOR

getdomainname was developed by Sun Microsystems, Inc.