unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



getdomainname(2)					     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 res-
  tricted 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 dif-
  ferent domain	name.  At the current time, only the Network Information Ser-
  vice (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

  [EFAULT]
      The name parameter contains an invalid address.

  [EPERM]
      The caller was not the superuser.	 This error message only applies to
      the setdomainname	system call.