source: trunk/third/sysinfo/README @ 12269

Revision 12269, 13.4 KB checked in by ghudson, 26 years ago (diff)
This commit was generated by cvs2svn to compensate for changes in r12268, which included commits to RCS files with non-trunk default branches.
Line 
1                            [MagniComp Systems]
2----------------------------------------------------------------------------
3
4                                         SysInfo Home Page
5      GENERAL                    http://www.magnicomp.com/sysinfo/
6   INFORMATION:
7       Home        Description
8     Downloads
9    Contact Us     SysInfo displays various types of information about a host's
10   Contributions   hardware and operating system (OS) software. It is intended
11     Licensing     to provide information in both human readable and program
12                   parsable formats. System Administrators can use SysInfo to
13   OUR SOFTWARE:   obtain hardware asset information and OS configuration
14                   information. Programs which use SysInfo can obtain this
15      SYSINFO      information in a platform independent manner.
16    Show system
17  information and  The amount of information displayed varies by operating
18  configuration.   system. Here are some of the types of information that may be
19                   provided (varies by platform):
20       RDIST
21  Remote software     * Host name
22   distribution       * Host name aliases
23     system.          * Host network addresses
24                      * Host ID
25       QTERM          * System serial number
26    Automaticly       * Manufacturer of the system's hardware
27  query terminal      * System model name
28   for terminal       * CPU type
29      type.           * Application architecture
30                      * Kernel architecture
31                      * Amount of main memory
32                      * Operating system name
33                      * Operating system version
34                      * Kernel version
35                      * A variety of information about devices
36                      * A variety of different kernel parameters
37                      * A variety of different system configuration parameters
38
39                   Most of the OS specific information was determined by
40                   groveling /usr/include/{sys,machine,*dev}/*.h files, section
41                   4 man pages, and reverse engineering the output from various
42                   commands like devinfo (SunOS) and using the trace(2)
43                   facility. Some of the network (netif) code was inspired by
44                   the sources to the 4.3BSD netstat and ifconfig commands.
45
46                   Example Output
47
48                   The following are examples of output from SysInfo from
49                   various (but not all) platforms:
50
51                    Man.     Model         OS             SysInfo Output
52
53                    Sun    Ultra 30   Solaris 2.6  Default human readable
54                                                   output
55
56                    Sun    Ultra 30   Solaris 2.6  Full human readable output
57
58                    Sun    Ultra 30   Solaris 2.6  Full program readable
59                                                   output
60
61                    IBM   RS6000 975    AIX 4.2    Default human readable
62                                                   output
63
64                    IBM   RS6000 975    AIX 4.2    Full human readable output
65
66                    SGI   Origin 2000   IRIX 6.4   Full human readable output
67
68                   Supported Platforms
69
70                   The following table indicates what platforms are supported
71                   for the current release of SysInfo. This platform list is
72                   subject to change with each dot dot release of SysInfo.
73
74                                               SysInfo Class of
75                                                  Information
76
77                    Man.     OS     Hard-   Gen-  Ker-   Sys-  Dev-    Notes
78                                     ware   eral   nel   conf  ice
79
80                          Solaris
81                                                                       May no
82                    Sun    1.x /    SPARC    Y      Y     Y     Y      longer
83                           SunOS
84                           4.1.4                                       work.
85
86                          Solaris                                      SunOS
87                                                                     5.5.1 and
88                    Sun    2.x /    SPARC    Y      Y     Y     Y       5.6
89                           SunOS
90                            5.x                                       verified
91                                                                      working.
92
93                          Solaris                                      SunOS
94                                                                       5.5.1
95                    Sun    2.x /     x86     Y      Y     Y     Y    tested on
96                           SunOS
97                            5.x                                       limited
98                                                                     hardware.
99
100                    IBM   AIX 3.x,  RS6000   Y      N     Y     Y
101                            4.x
102
103                            IRIX                                      IRIX 5.x
104                    SGI     5.3,     MIPS    Y      N     Y     Y      may no
105                          6.[0-4]                                      longer
106                                                                        work
107
108                     HP    HP-UX    hp9000   Y      Y     N     P
109                          9.x 10.x
110
111                    KEY:
112                    Y - Yes, it's supported
113                    N - No, it's not supported
114                    P - Planned
115
116                   Releases
117
118                   Information about releases is available from
119                   http://www.magnicomp.com/sysinfo/release.htm.
120
121                   Status
122
123                   SysInfo is under ongoing development. Releases occur 2-4
124                   times per year.
125
126                   Download
127
128                                        Click To Download
129
130                   Installation
131
132                     1. Follow the instructions to Download and unpack a
133                        distribution. You can either download complete source
134                        and build (compile) from scratch, or you can choose to
135                        download a precompiled version. Use the precompiled
136                        distributions if there is a distribution available for
137                        your platform and the default path to sysinfo
138                        configuration files (/var/local/conf/sysinfo) is
139                        acceptable. You must download the source and compile
140                        otherwise. Please note that sysinfo should only be run
141                        on the same OS version as it was compiled on. i.e. If
142                        compiled on SunOS 5.5, do not run the same binary on
143                        5.6.
144                     2. If compiling from source:
145                          1. Read the comments in `Makefile' and make any
146                             necessary changes. You probably will want to change
147                             the PREFIX and/or CONFDIR variables.
148                          2. Run `make'. Please note the following:
149                                + You will almost always need to compile SYSINFO
150                                  on _EACH_ version of your operating system
151                                  (OS).
152                                + Under SunOS 4.x, you must compile SYSINFO for
153                                  each kernel architecture (karch) and each OS
154                                  version. i.e. "sun4c SunOS 4.1.4", "sun4m
155                                  SunOS 4.1.4", etc. This is not necessary under
156                                  SunOS 5.x.
157                     3. Continue with the following instructions for both source
158                        compiles and binary distribution downloads...
159                     4. Run `make test' to run sysinfo right now as a test.
160                     5. To install the sysinfo program, you can either use `make
161                        installmeta' (read the file `metasysinfo' for details)
162                        or you can run `make install'.
163                     6. Run `make install.man' to install the man page.
164
165                   Reporting Problems
166
167                   Please Contact Us to send bug fixes, suggestions, and
168                   comments. When reporting bugs, please include output from
169                   "sysinfo -level all -debug +unknown" whenever possible.
170
171                   Platform Notes
172
173                   The following are notes regard specific platforms:
174
175                      * SunOS 4.x
176
177                        SYSINFO should be compiled for each kernel architecture
178                        machine you wish to run it on. This is only needed for
179                        SunOS 4.x. It is _NOT_ required for Solaris 2.x/SunOS
180                        5.x. (SYSINFO is normally installed into /usr/kvm and
181                        symlinked into something like /usr/local/bin.) This is
182                        necessary if you wish to be able to get the PROM version
183                        information. The SunOS 4.x interface to the PROM
184                        information does not permit having one binary that can
185                        determine the PROM information on all the different
186                        kernel architectures. This interface problem is fixed in
187                        Solaris 2.x/SunOS 5.x.
188
189                        Your kernel must have NIT (Network Interface Tap)
190                        compiled into it in order to determine the Ethernet MAC
191                        address under SunOS 4.x.
192
193                      * Solaris 2.4/SunOS 5.4
194
195                        Due to a change in SunOS 5.4, "ROM Version" information
196                        is not shown unless Sun patch 102555-01 or later is
197                        installed. This problem does not exist in SunOS 5.5
198                        because Sun added a new interface to get this
199                        information.
200
201                      * Solaris 2.x/SunOS 5.x
202
203                        Unlike SunOS 4.x, you only need one SYSINFO binary for
204                        each Solaris 2.x release. You do not need one for each
205                        kernel architecture. i.e. SYSINFO compiled under Solaris
206                        2.2 on a SPARC machine will run on any Solaris 2.2 SPARC
207                        machine of any kernel architecture.
208
209                        Under Solaris 2.2 FCS on sun4d hosts (like the
210                        SPARCcenter-2000), the kernel has an empty value for the
211                        system "root nexus". This means that you will not see a
212                        proper device tree on such systems. Various nodes will
213                        not be attached where they should be. This bug cropped
214                        up between Solaris 2.2 ER2 and FCS and is fixed in
215                        Solaris 2.3.
216
217                      * HP
218
219                        HP 9000 800 series machines are not supported unless
220                        running HP-UX 10.0 or later.
221
222                      * IRIX
223
224                        The IRIX OS comes with a command called "sysinfo"
225                        (/sbin/sysinfo) that shows a system's serial number.
226                        This normally should not present a problem since this
227                        program is not normally used by users (/sbin should not
228                        be in a normal user's $PATH) and is normally only run by
229                        programs using the explicit path of /sbin/sysinfo.
230                        However, if you do wish to install sysinfo using another
231                        name you may do so by setting the ${PROG} variable in
232                        Makefile.
233
234                      * AIX
235
236                        When looking up device information, SYSINFO uses the AIX
237                        "National Language Catalogs". This means that your $LANG
238                        environment variable must be set correctly. If it is
239                        not, SYSINFO may fail to find most device information.
240
241                        Support for AIX 4.* is not yet availible. I don't have
242                        access to such a machine yet. From what I can tell,
243                        though, it should be a very straight forward port -
244                        probably just modifying the Makefile.
245
246                      * SPP-UX
247
248                        In SPP-UX 2.0.2 you may see these errors at
249                        compile-time::
250
251                          cc: Warning on line 109 of /usr/include/sys/wait.h: a \
252                              bit field must have type int or unsigned int
253
254                        These errors are due to a bug in and/or Convex C. Convex
255                        is aware of the problem and promises a fix at some
256                        point. The errors can safely be ignored.
257
258                      * Ultrix, NeXT
259
260                        Support for these platforms has been phased out. The
261                        last version of sysinfo with support for these platforms
262                        is version 3.0.6 which is availible in
263                        ftp://usc.edu/pub/sysinfo/obsolete.
264
265----------------------------------------------------------------------------
266                        This site made possible by:
267                                  [Image]
268----------------------------------------------------------------------------
269Michael A. Cooper
270Last modified: Mon Mar 9 16:32:53 PST 1998
Note: See TracBrowser for help on using the repository browser.