sethostname(2) System Calls Manual sethostname(2)
NAME
sethostname - Sets the name of the current host
SYNOPSIS
int sethostname ( char *name, int name_len );
PARAMETERS
Points to an array of bytes where the host name is stored. 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 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: The name parameter or the name_len parameter gives an
address that is not valid. The calling process does not have appropriate privilege.
RELATED INFORMATION
Functions: gethostid(2), sethostid(2), gethostname(2) delim off
sethostname(2)
