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(5) for descriptions of the following attributes:

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