Content-type: text/html Man page of sethostid

sethostid

Section: System Calls (2)
Index Return to Main Contents
 

NAME

sethostid - Sets the unique identifier of the current host  

SYNOPSIS

int sethostid (        int host_id );
 

PARAMETERS

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 which may be used by application programs. It is usually set to the primary IP address of the local machine.

The sethostid() function fails if the calling process does not have 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: The calling process does not have the appropriate privilege.  

RELATED INFORMATION

Functions: gethostid(2), gethostname(2) delim off


 

Index

NAME
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
ERRORS
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:14 GMT, October 02, 2010