hpux man page for gethostname

gethostname(2)							System Calls Manual						    gethostname(2)

NAME
       gethostname() - get name of current host system

SYNOPSIS
DESCRIPTION
       returns	in  the array to which hostname points, the standard host name for the current system as set by (see sethostname(2)).  size speci-
       fies the length of the hostname array.  hostname is null-terminated unless insufficient space is provided.

RETURN VALUE
       returns 0 if successful.  Otherwise, it returns -1 and sets to indicate the error.

ERRORS
       can fail if the following is true:

       hostname       points to an illegal address.  The reliable detection of this error is implementation dependent.

       size	      is less than one.

WARNINGS
       It is recommended that programs use to dynamically size the buffer used to accept the host name from This is preferred over use of the con-
       stant.

       For  cases where the constant must be used, there are two values: 64 and 256.  The smaller value is compatible with current releases and is
       used by default.  To use the larger value consult the related documentation (see nodehostnamesize(5)).

       The administrator may, with appropriate configuration options enabled, set a host name larger than 64 bytes.  Existing  applications  which
       were  compiled  using the smaller to size a buffer passed to the system function obtain only the first 64 bytes.  This truncation may cause
       the applications to exhibit anomalous behavior or to fail.

AUTHOR
       was developed by the University of California, Berkeley.

SEE ALSO
       hostname(1), uname(1), sethostname(2), uname(2), nodehostnamesize(5).

																    gethostname(2)