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.

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

Last modified: 2013-12-23

comments powered by Disqus