unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



sethostname(2)						       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 host name is stored.

  name_len  Specifies the length of the	array pointed to by the	name parame-
	    ter.

DESCRIPTION

  The sethostname() function allows a calling process with root	user author-
  ity 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 follow-
  ing 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)