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)