unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



gethostname(2)						       gethostname(2)



NAME
  gethostname -	Gets the name of the local host

SYNOPSIS

  #include <&lt;unistd.h>&gt;

  int gethostname (
	  char *name,
	  size_t namelen );

  The following	definition of the gethostname()	function does not conform to
  current standards and	is supported only for backward compatibility:

  #include <&lt;unistd.h>&gt;

  int gethostname (
	  char *name,
	  int name_len );

STANDARDS

  Interfaces documented	on this	reference page conform to industry standards
  as follows:

  gethostname():  XNS5.0

  Refer	to the standards(5) reference page for more information	about indus-
  try standards	and associated tags.

PARAMETERS

  name	    Specifies the address of an	array of bytes where the host name is
	    stored.

  namelen   Specifies the length of the	array pointed to by the	name parame-
	    ter.

DESCRIPTION

  The gethostname() function retrieves the host	name of	the local host as it
  is configured	on the system.	If a fully-qualified domain name is config-
  ured as the host name, that name is returned.	 If sufficient space is	pro-
  vided, the returned name is null-terminated.

  System host names are	limited	to MAXHOSTNAMELEN as defined in	the
  /usr/include/sys/param.h file.

  The gethostname() function allows a calling process to determine the inter-
  nal host name	for a machine on a network.



RETURN VALUES

  Upon successful completion, a	value of 0 (zero) is returned.	Otherwise, a
  value	of -1 is returned.


  If the version of gethostname() provided for backward	compatibility returns
  a -1,	errno is also set to indicate the error.

ERRORS

  If the gethostname() function	provided for backward compatibility fails,
  errno	may be set to the following value:

  [EFAULT]  The	address	parameter or address_len parameter gives an invalid
	    address.

RELATED	INFORMATION

  Functions: gethostid(2), sethostid(2), sethostname(2)

  Standards: standards(5)