sethostname()

set the name of the current host

Synopsis:

#include <unix.h>

int sethostname( char *name, 
                 int namelen );

Description:

The sethostname() function sets the name of the host machine to be name. The namelen argument specifies the length of name.

Returns:

0

Success.

-1

An error occurred; errno is set.

Errors:

If an error occurred, errno could contain one of the following:

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

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

See also:

gethostname()