getdomainname man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

getdomainname(2)					      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 spec‐
       ifies the size of the name array.  The returned	value  is  null-termi‐
       nated  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 hav‐
       ing  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)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net