OSF

NAME

gethostname − Gets the name of the local host

SYNOPSIS

int gethostname (
char ∗address,
int address_len );

PARAMETERS

addressReturns the address of an array of bytes where the hostname is stored. 

address_lenSpecifies the length of the array pointed to by the address parameter. 

DESCRIPTION

The gethostname() function retrieves the standard host name of the local host. If sufficient space is provided, the returned address parameter 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 and errno is set to indicate the error. 

ERRORS

If the gethostname() function 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)