(i[34]86sol2): New abbrev for i[34]86-unknown-solaris2.

[kopensolaris-gnu/glibc.git] / manual / sysinfo.texi

diff --git a/manual/sysinfo.texi b/manual/sysinfo.texi
index b8e02fa..e384f8d 100644 (file)
--- a/manual/sysinfo.texi
+++ b/manual/sysinfo.texi
@@ -18,7 +18,7 @@ software, and the individual machine's name.
 
 This section explains how to identify the particular machine that your
 program is running on.  The identification of a machine consists of its
-Internet host name and Internet address; see @ref{Internet Domain}.  
+Internet host name and Internet address; see @ref{Internet Namespace}.  
 
 @pindex hostname
 @pindex hostid
@@ -74,9 +74,13 @@ This process cannot set the host name because it is not privileged.
 
 @comment unistd.h
 @comment BSD
-@deftypefun {long int} gethostid ()
+@deftypefun {long int} gethostid (void)
 This function returns the Internet address of the machine the program is
 running on.
+@c !!! this is not necessarily the IP address.  it is whatever was set
+@c with sethostid (or the `hostid' program).  on sun4s, it is an
+@c unchangeable constant that is unique for each machine.
+@c making it the primary IP address is a convention.
 @end deftypefun
 
 @comment unistd.h
@@ -112,9 +116,7 @@ by the @code{uname} function.  It has the following members:
 
 @table @code
 @item char sysname[]
-This is the name of the operating system implementation.  In the
-GNU library, the value is the string @code{"GNU C Library"}.
-@strong{Incomplete:} That had better not be true.
+This is the name of the operating system in use.
 
 @item char nodename[]
 This is the network name of this particular computer.  In the GNU
@@ -131,6 +133,7 @@ system.
 @item char machine[]
 This is a description of the type of hardware that is in use.
 
+@c !!! this is only true if the operating system has no uname system call.
 The GNU C Library fills in this field based on the configuration name
 that was specified when building and installing the library.  GNU uses a
 three-part name to describe a system configuration; the three parts are
@@ -144,10 +147,13 @@ Since the value in @code{machine} is supposed to describe just the
 hardware, it consists of the first two parts of the configuration name:
 @samp{@var{cpu}-@var{manufacturer}}.
 
+@c !!! this is yet another case where you are losing massively because
+@c you want to have an explicit list.  many others are possible.
 Here is a list of all the possible alternatives:
 
 @quotation
-@code{"i386-@var{anything}"}, @code{"m68k-hp"}, @code{"sparc-sun"}
+@code{"i386-@var{anything}"}, @code{"m68k-hp"}, @code{"sparc-sun"},
+@code{"m68k-sun"}, @code{"m68k-sony"}, @code{"mips-dec"}
 @end quotation
 @end table
 @end deftp
@@ -158,11 +164,8 @@ Here is a list of all the possible alternatives:
 The @code{uname} function fills in the structure pointed to by
 @var{info} with information about the operating system and host machine.
 A non-negative value indicates that the data was successfully stored.
-@code{-1} as the value indicates an error.
 
-@strong{Incomplete:} What can cause an error in this function?
+@code{-1} as the value indicates an error.  The only error possible is
+@code{EFAULT}, which we normally don't mention as it is always a
+possibility.
 @end deftypefun
-
-
-
-