sethostid(2) [osf1 man page]

sethostid(2)							System Calls Manual						      sethostid(2)

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

       Commands: hostid(1).

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

																      sethostid(2)

Check Out this Related Man Page

GETHOSTID(2)						     Linux Programmer's Manual						      GETHOSTID(2)

NAME

       gethostid, sethostid - get or set the unique identifier of the current host

SYNOPSIS

       #include <unistd.h>

       long gethostid(void);
       int sethostid(long hostid);

DESCRIPTION

       Get  or	set  a unique 32-bit identifier for the current machine.  The 32-bit identifier is intended to be unique among all UNIX systems in
       existence. This normally resembles the Internet address for the local machine, as returned by  gethostbyname(3),  and  thus  usually  never
       needs to be set.

       The sethostid call is restricted to the superuser.

       The hostid argument is stored in the file /etc/hostid.

RETURN VALUE

       gethostid returns the 32-bit identifier for the current host as set by sethostid(2).

CONFORMING TO

       4.2BSD.	 These	functions  were  dropped  in  4.4BSD.	POSIX.1  does not define these functions, but ISO/IEC 9945-1:1990 mentions them in
       B.4.4.1.  SVr4 includes gethostid but not sethostid.

FILES

       /etc/hostid

SEE ALSO

       hostid(1), gethostbyname(3)

Linux 0.99.13							    1993-11-29							      GETHOSTID(2)

Linux and UNIX Man Pages

sethostid(2) [osf1 man page]

Check Out this Related Man Page