sethostname()

Set the name of the current host

Synopsis:

#include <unix.h>

int sethostname( char * name, 
                 int namelen );

Library:

socket3r.lib, socket3s.lib

Description:

The sethostname() function sets the name of the host machine to be name. The length of name is set by namelen. Restricted to the superuser, this call is normally used only at boot time.

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:

Unix

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes

Caveats:

This function is restricted to the superuser, and is normally used only at boot time.

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