4.4BSD snapshot (revision 8.1)

[unix-history] / usr / src / lib / libc / compat-43 / gethostid.3

diff --git a/usr/src/lib/libc/compat-43/gethostid.3 b/usr/src/lib/libc/compat-43/gethostid.3
index 0c30b67..ee2a234 100644 (file)
--- a/usr/src/lib/libc/compat-43/gethostid.3
+++ b/usr/src/lib/libc/compat-43/gethostid.3
@@ -1,34 +1,49 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\"    @(#)gethostid.3 6.3 (Berkeley) %G%
+.\" %sccs.include.redist.man%

 .\"
 .\"

-.TH GETHOSTID 2 ""
-.UC 5
-.SH NAME
-gethostid, sethostid \- get/set unique identifier of current host
-.SH SYNOPSIS
-.nf
-.ft B
-hostid = gethostid()
-long hostid;
-.PP
-.ft B
-sethostid(hostid)
-long hostid;
-.fi
-.SH DESCRIPTION
-.I Sethostid
+.\"     @(#)gethostid.3        8.1 (Berkeley) %G%
+.\"
+.Dd 
+.Dt GETHOSTID 3
+.Os BSD 4.2
+.Sh NAME
+.Nm gethostid ,
+.Nm sethostid
+.Nd get/set unique identifier of current host
+.Sh SYNOPSIS
+.Fd #include <unistd.h>
+.Ft long
+.Fn gethostid void
+.Ft int
+.Fn sethostid "long hostid"
+.Sh DESCRIPTION
+.Fn Sethostid

 establishes a 32-bit identifier for the
 current processor that is intended to be unique among all
 UNIX systems in existence.  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.
 establishes a 32-bit identifier for the
 current processor that is intended to be unique among all
 UNIX systems in existence.  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.

-.PP
-.I Gethostid
+.Pp
+.Fn Gethostid

 returns the 32-bit identifier for the current processor.
 returns the 32-bit identifier for the current processor.

-.SH SEE ALSO
-hostid(1), gethostname(2)
-.SH BUGS
+.Pp
+This function has been deprecated.
+The hostid should be set or retrieved by use of
+.Xr sysctl 2 .
+.Sh SEE ALSO
+.Xr sysctl 2 ,
+.Xr gethostname 3 ,
+.Xr sysctl 8 .
+.Sh BUGS

 32 bits for the identifier is too small.
 32 bits for the identifier is too small.

+.Sh HISTORY
+The
+.Fn gethostid
+and
+.Fn sethostid
+syscalls appeared in 
+.Bx 4.2
+and were dropped in
+.Bx 4.4 .