Content-type: text/html Man page of gethostname

gethostname

Section: System Calls (2)
Index Return to Main Contents
 

NAME

gethostname - Gets the name of the local host  

SYNOPSIS

#include <unistd.h>

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 <unistd.h>

int gethostname (        char *name,
       int name_len );
 

STANDARDS

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

gethostname(): XPG4-UNIX

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

PARAMETERS

Specifies the address of an array of bytes where the hostname is stored. Specifies the length of the array pointed to by the name parameter.  

DESCRIPTION

The gethostname() function retrieves the standard host name of the local host. If sufficient space is provided, the returned name is null-terminated.

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

The gethostname() function allows a calling process to determine the internal hostname 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: The address parameter or address_len parameter gives an invalid address.  

RELATED INFORMATION

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

Standards: standards(5) delim off


 

Index

NAME
SYNOPSIS
STANDARDS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:16 GMT, October 02, 2010