NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES
#include <unistd.h>int gethostname(char * hostname, size_t len);
POSIX_SOCKETS
The pair of primitives gethostname and sethostname are used to get and set the name of the machine, respectively. The value of the len field defines the length of the name, and is limited to MAXHOSTNAMELEN (from <sys/param.h>).
Currently, the value of MAXHOSTNAMELEN is 64.
Upon successful completion, these primitives return 0; otherwise -1 is returned, and the global variable errno is set to indicate one of the following error conditions.
The gethostname primitive fails if:
len is less than the current length of the machine name.
The name or namelen gave an invalid address.
The sethostname primitive fails if either of the following are true:
The new length of the machine name is greater than MAXHOSTNAMELEN.
Currently, the value of MAXHOSTNAMELEN is 64
The caller is not the superuser.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | FEATURES | DESCRIPTION | RETURN VALUES | ERRORS | ATTRIBUTES