gethostname()

Updated: April 19, 2023

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>).