Index for Section 2

Alphabetical listing for S

Bottom of page

sethostid(2)
NAME
  sethostid - Set the unique identifier of the current host

SYNOPSIS
  int sethostid(
	  int host_id );

PARAMETERS
  host_id
      Specifies the unique 32-bit identifier for the current host.

DESCRIPTION
  The sethostid() function allows a calling process with a root user ID to
  set a new 32-bit identifier for the current host.  The sethostid() function
  enables an application program to reset the host ID. The host ID is a
  unique number that may be used by application programs. It is usually set
  to the primary Internet address of the local machine, represented as a
  network standard byte order integer.

  The sethostid() function fails if the calling process does not have the
  superuser privilege.

RETURN VALUES
  Upon successful completion, the sethostid() function returns a value of 0
  (zero). If the sethostid() function fails, a value of -1 is returned and
  errno is set to indicate the error.

ERRORS
  If the sethostid() function fails, errno may be set to the following value:

  [EPERM]
      The calling process does not have the appropriate privilege.

SEE ALSO
  Commands: hostid(1).

  Functions: gethostid(2), gethostname(2).

Index for Section 2

Alphabetical listing for S

Top of page