gethostname()
QNX SDP8.0C Library ReferenceAPIDeveloper
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:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Signal handler | Yes |
| Thread | Yes |
Caveats:
Hostnames are limited to MAXHOSTNAMELEN characters (defined in <sys/param.h>).
Page updated: