sethostname()
QNX SDP8.0C Library ReferenceAPIDeveloper
Set the name of the current host
Synopsis:
#include <unistd.h>
int sethostname( const char * name,
size_t namelen );
Arguments:
- name
- The name that you want to use for the host machine. Hostnames are limited to MAXHOSTNAMELEN characters (defined in <sys/param.h>).
- namelen
- The length of the name.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The sethostname() function sets the name of the host machine to be name. Only the superuser can call this function; this is normally done only at boot time.
Note:
This function sets the value of the
_CS_HOSTNAME
configuration string, not that of the HOSTNAME environment variable.
Returns:
- 0
- Success.
- -1
- An error occurred (errno is set).
Errors:
- EFAULT
- Either name or namelen gave an invalid address.
- EPERM
- Although the caller wasn't the superuser, it tried to set the hostname.
Classification:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Signal handler | Yes |
| Thread | Yes |
Caveats:
This function is restricted to the superuser, and is normally used only at boot time.
Page updated: