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(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
uname(1),
gethostid(3C),
attributes(7),
standards(7) June 10, 2002 GETHOSTNAME(3XNET)
