Index for Section 2

Alphabetical listing for S

Bottom of page

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
	    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:

  [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)

Index for Section 2

Alphabetical listing for S

Top of page