home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume26 / sysinfo-1.0 / part01 / README < prev    next >
Text File  |  1993-04-10  |  3KB  |  96 lines
  1.  
  2.                 SYSINFO 1.0
  3.  
  4.              Michael A. Cooper
  5.            Research, Development, and Systems Group
  6.             University Computing Services
  7.           University of Southern California
  8.               mcooper@usc.edu
  9.  
  10.  
  11. GENERAL INFORMATION
  12.  
  13. This is version 1.0 of sysinfo.  Sysinfo is a program which shows
  14. various pieces of information about a system.  The original version
  15. was written to simply determine the model name of a system for use in
  16. /etc/motd.  It also supported a few other pieces of information that
  17. were simple to obtain, but the method used to obtain the information
  18. on various different OS's varied.  The current version shows many
  19. different "general" bits of system information as well as fairly
  20. detailed information on system devices such as disk drives, frame
  21. buffers, tape drives, and many others.  A lot of the information
  22. sysinfo displays is difficult, if not impossible, to determine by
  23. normal OS commands and/or files after boot time on many OS's.
  24.  
  25. Most of the OS specific information was determined by groveling
  26. /usr/include/{sys,machine,*dev}/*.h files, section 4 man pages, and
  27. reverse engineering the output from various commands like devinfo
  28. (SunOS) and using the trace(2) facility.  Some of the network (netif)
  29. code was inspired by the sources to the 4.3BSD netstat and ifconfig
  30. commands.
  31.  
  32. SUPPORTTED PLATFORMS
  33.  
  34. Sysinfo has been tested on the platforms listed below.  Porting to
  35. other BSD based Unix's is fairly straight-forward.
  36.  
  37.     Sun-3            SunOS 4.0.3, 4.1.1
  38.     Sun-386            SunOS 4.0.1
  39.     Sun-4            SunOS 4.0.3, 4.1.1, 4.1.2
  40.     SPARCbook-1        Solaris 1.0.1 SPARCbook Version A.3
  41.     Solbourne Series5E    OS/MP 4.1A
  42.     DEC MIPS        Ultrix 4.1, 4.2
  43.     NeXT            NeXT 2.1
  44.     IBM RS6000        *AIX 3.1
  45.     Alliant         *Concentrix 5.X, *Concentrix-2800 2.0
  46.     HP300            *MORE/bsd 4.3 (BSD)
  47.  
  48.         * - No device information support
  49.  
  50.  
  51. INSTALLATION
  52.  
  53. Installing on one of the platforms listed above should just be a
  54. matter of editing Makefile and running "make".
  55.  
  56. Run "make install" to install the sysinfo binary and "make
  57. install.man" to install the man page.
  58.  
  59. BUG FIXES
  60.  
  61. Please send bug fixes, suggestions, and comments to mcooper@usc.edu.
  62.  
  63. WHERE TO GET IT
  64.  
  65. The latest/greatest version of sysinfo is available via anonymous ftp
  66. on usc.edu in /pub/sysinfo.
  67.  
  68. PLATFORM SPECIFIC NOTES
  69.  
  70. The following are notes regarding specific platforms:
  71.  
  72. SunOS    Sysinfo should be compiled for each kernel architecture machine
  73.     you wish to run it on.  It is normally installed into /usr/kvm
  74.     and symlinked into something like /usr/local/bin.
  75.  
  76.     Sun386i device support is shakey, at best.  No SCSI disk info
  77.     is found.  The kernel device init table doesn't seem to have
  78.     any of the disk info in it.  I haven't had time to track this
  79.     down.
  80.  
  81. NeXT    The C compiler under NeXT 2.1 is an old version of GCC (1.34).
  82.     That version is broken and will not compile sysinfo.  We installed
  83.     GCC 2.0 without problem under NeXT 2.1 and it seems to work
  84.     very well with sysinfo.
  85.  
  86.     Network address info for network interfaces is not working.  There
  87.     is currently no debugger that works with GCC 2.0 so I haven't spent
  88.     time on this.
  89.  
  90. OTHER KNOWN PROBLEMS
  91.  
  92. SPARCbook "id" DISKS
  93.     The label on "id" disks on the SPARCbook-1 cannot be read.  This
  94.     appears to be because the definition of IDE_READ in 
  95.     <taddev/ide_drvr_def.h> is incorrect.
  96.