Index for Section 2

Alphabetical listing for G

Bottom of page

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 having 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
  [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.

Index for Section 2

Alphabetical listing for G

Top of page