NAME

sethostname − Sets the name of the current host

SYNOPSIS

int sethostname (
char ∗name,
int name_len );

PARAMETERS

namePoints to an array of bytes where the hostname is stored. 

name_lenSpecifies 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 hostname of a machine on a network. 

System hostnames 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 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. 

RELATED INFORMATION

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