Click this button to go to the index for this section.

sethostname(2)
NAME
  sethostname - Sets the name of the current host

SYNOPSIS
  int sethostname (
	  char *name,
	  int name_len );

PARAMETERS
  name	    Points to an array of bytes where the hostname 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 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)