GETHOSTNAME(3XNET) X/Open Networking Services Library Functions
gethostname - get name of current host
cc [ flag ... ] file ... -lxnet [ library ... ]
#include <unistd.h>
int gethostname(char *name, size_t namelen);
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.
On successful completion, 0 is returned. Otherwise, -1 is returned.
No errors are defined.
See attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
uname(1), gethostid(3C), attributes(7), standards(7)
June 10, 2002 GETHOSTNAME(3XNET)
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)