gethostname()

Get the name of the current host

Synopsis:

#include <unistd.h>

int gethostname( char * name,
                 size_t namelen );

Arguments:

name: A buffer where the function can store the host name.
namelen: The size of the buffer.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The gethostname() function stores in name the standard hostname for the current processor, as previously set by sethostname(). The parameter namelen specifies the size of the name array. The returned name is NULL-terminated unless insufficient space is provided.

Note: This function gets the value of the _CS_HOSTNAME configuration string, not that of the HOSTNAME environment variable.

Returns:

0: Success.
-1: An error occurred (errno isn't set).

Classification:

POSIX 1003.1

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes

Caveats:

Hostnames are limited to MAXHOSTNAMELEN characters (defined in <sys/param.h>).