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.

     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)