sethostname(2)sethostname(2)NAMEsethostname - Set 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 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: The name parameter or the name_len parameter gives an
address that is not valid. The calling process does not have appropriā
ate privilege.
SEE ALSO
Functions: gethostid(2), sethostid(2), gethostname(2)sethostname(2)