NAME

sethostname − Set the name of the current host

SYNOPSIS

int sethostname(
        char ∗name,
        int name_len );

PARAMETERS

name
Points to an array of bytes where the host name is stored.

name_len
Specifies the length of the array pointed to by the name parameter. 

DESCRIPTION

The sethostname() function allows a calling process with root user authority to set the internal host name of a machine on a network. 

System host names are limited to MAXHOSTNAMELEN as defined in the /usr/include/sys/param.h file. 

The sethostid() function fails if the calling process does not have the superuser privilege. 

RETURN VALUES

Upon successful completion, the system returns a value of 0 (zero).  If the sethostname() function fails, -1 is returned and errno is set to indicate the error. 

ERRORS

If the sethostname() function fails, errno may be set to one of the following values:

[EFAULT]
The name parameter or the name_len parameter gives an address that is not valid. 

[EPERM]
The calling process does not have appropriate privilege.

SEE ALSO

Functions: gethostid(2), sethostid(2), gethostname(2)