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

FreeBSD Manual Pages

  
 
  

home | help 
GETHOSTID(3)		    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 cur-
       rent processor that is intended to be unique among all UNIX systems  in
       existence.  This	is normally a DARPA Internet address for the local ma-
       chine.	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 re-
       trieved 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	15.0			 June 2, 1993			  GETHOSTID(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gethostid&sektion=3&manpath=FreeBSD+15.0-RELEASE+and+Ports.quarterly>

home | help