Index for Section 2

Alphabetical listing for S

Bottom of page

sethostname(2)
NAME
  sethostname - Set 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 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:

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

SEE ALSO
  Functions: gethostid(2), sethostid(2), gethostname(2)

Index for Section 2

Alphabetical listing for S

Top of page