GETHOSTNAME(3XNET) X/Open Networking Services Library Functions


NAME


gethostname - get name of current host

SYNOPSIS


cc [ flag ... ] file ... -lxnet [ library ... ]
#include <unistd.h>

int gethostname(char *name, size_t namelen);


DESCRIPTION


The gethostname() function returns the standard host name for the current
machine. The namelen argument specifies the size of the array pointed to
by the name argument. The returned name is null-terminated, except that
if namelen is an insufficient length to hold the host name, then the
returned name is truncated and it is unspecified whether the returned
name is null-terminated.


Host names are limited to 255 bytes.

RETURN VALUES


On successful completion, 0 is returned. Otherwise, -1 is returned.

ERRORS


No errors are defined.

ATTRIBUTES


See attributes(5) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


uname(1), gethostid(3C), attributes(5), standards(5)


June 10, 2002 GETHOSTNAME(3XNET)