Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
GETHOSTID(3)	       FreeBSD Library Functions Manual		  GETHOSTID(3)

NAME
     gethostid,	sethostid -- get/set unique identifier of current host

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <unistd.h>

     long
     gethostid(void);

     void
     sethostid(long hostid);

DESCRIPTION
     The sethostid() function establishes a 32-bit identifier for the current
     processor that is intended	to be unique among all UNIX systems in exis-
     tence.  This is normally a	DARPA Internet address for the local machine.
     This call is allowed only to the super-user and is	normally performed at
     boot time.

     The gethostid() function returns the 32-bit identifier for	the current
     processor.

     This function has been deprecated.	 The hostid should be set or retrieved
     by	use of sysctl(3).

SEE ALSO
     gethostname(3), sysctl(3),	sysctl(8)

HISTORY
     The gethostid() and sethostid() syscalls appeared in 4.2BSD and were
     dropped in	4.4BSD.

BUGS
     32	bits for the identifier	is too small.

FreeBSD	9.3			 June 2, 1993			   FreeBSD 9.3

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | SEE ALSO | HISTORY | BUGS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=sethostid&manpath=FreeBSD+10.0-RELEASE>

home | help