sethostid Subroutine

Purpose

Sets the unique identifier of the current host.

Library

Standard C Library (libc.a)

Syntax

int sethostid ( HostID) int HostID;

Description

The sethostid subroutine allows a calling process with a root user ID to set a new 32-bit identifier for the current host. The sethostid subroutine enables an application program to reset the host ID.

All applications containing the sethostid subroutine must be compiled with the _BSD macro set to a specific value. Acceptable values are 43 and 44. In addition, all socket applications must include the BSD libbsd.a library.

Parameters

Item	Description
HostID	Specifies the unique 32-bit identifier for the current host.

Return Values

Upon successful completion, the sethostid subroutine returns a value of 0.

If the sethostid subroutine is unsuccessful, the subroutine handler performs the following functions:

Returns a value of -1 to the calling program.
Moves an error code, indicating the specific error, into the errno global variable. For further explanation of the errno variable see Error Notification Object Class in AIX® Version 7.1 Communications Programming Concepts.

Error Codes

The sethostid subroutine is unsuccessful if the following is true:

Error	Description
EPERM	The calling process did not have an effective user ID of root user.