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

  
 
  

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 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 15.1			  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.1-RELEASE+and+Ports.quarterly>

home | help