home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / DemoApps / Utilities / Other / Monitor / README < prev    next >
Encoding:
Text File  |  1993-12-21  |  4.2 KB  |  91 lines
  1. Changes made on Dec. 19, 1993, so Monitor.app runs on 3.x (Intel machines
  2. and Motorola):
  3.  
  4.   1. Ran 'make depend' from PB to clean up Makefile.dependencies.
  5.   2. Fixed import location to mach/vm_statistics.h in Monitor.h.
  6.      Fixed import location to defaults/defaults.h in Monitor.m.
  7.   3. Commented out #define KERNEL in Monitor.h to avoid re-defining
  8.      struct tm in time.h.
  9.   4. Changed NXImageBitmap() to NSDrawBitmap() in Monitor.m, fixing its
  10.      arguments as well.  Pure guesses as to values of miniBpp (bits per
  11.      pixel), miniBpr (bytes per row), and miniColorSpace is used
  12.      uninitialized.  (That gives a compiler warning.)
  13.   5. Initialized variables and parenthesized in StripChart.m to avoid
  14.      compiler warnings.
  15.  
  16. Things I didn't do in this update:
  17.  
  18.   1. Replace the obsolescent NSDrawBitmap() with methods from the
  19.      NXBitmapImageRep class.
  20.   2. Colorize the App.
  21.   3. Move the .nib file into an .lproj directory.
  22.  
  23. Remember to set Monitor.app/Monitor's group to kmem (use chgrp) and do 
  24. a "chmod g+s Monitor" after you install it.
  25.  
  26.    Dick Silbar
  27.    WhistleSoft, Inc.
  28.    (505)-662-7309
  29.    silbar@cantina.lanl.gov
  30.  
  31. ==========================================================================
  32.  
  33.  
  34. ORIGINAL README: Roy Mongiovi, Georgia Tech
  35.  
  36. This is Monitor, a program which takes the place of the Sun's perfmon and
  37. perfmeter for the NeXT under version 1.0 of the operating system.
  38.  
  39. Monitor can display up to 30 different statistics and combinations of
  40. statistics in a window, plus one statistic in the icon.
  41.  
  42. I wrote this without access to the source code, so it's possible that my
  43. guesses are incorrect about the meaning/interpretation of some of the
  44. values being displayed.  If anyone who know more about this than I do sees
  45. something wrong, please let me know.  If anyone knows of a statistic that
  46. is not being reported, please let me know.
  47.  
  48. I started by using "nm" to obtain a list of all non-text type symbols from
  49. /sdmach.  I then searched /usr/include for all occurrences of any of these
  50. variable names.  I edited this list down to the entries that I felt were
  51. really definitions/references to the variables from /sdmach.  This list is
  52. in the file "namelist".
  53.  
  54. Then I wrote the program "sample.c" to read and display the current values
  55. of variables that I felt contained statistics.  I found that many of the
  56. standard Unix statistics are not maintained by Mach, or are not updated in
  57. the same fashion as Unix.  A bit of experimentation with this progrom led
  58. me to the list of statistics that I incorporated into Monitor.
  59.  
  60. What statistics have been selected for display, what is currently on screen,
  61. the size and position of the window, etc. are all saved in the defaults
  62. database with the owner "Monitor."  What statistics have been selected is
  63. stored as a concatenated string of the titles of the statistics.  This string
  64. tends to get kind of long, and demonstrates a bug in the dread command.
  65. "dread -l" will memory fault when it tries to display the Monitor defaults.
  66. The file "defaults" is a list of commands that you can "source" with csh
  67. to display the current default settings.
  68.  
  69. When scrolling the statistics, Monitor construct a DPS user path in order
  70. to get some speed out of the display update, but it can still be kind of
  71. slow.  To help alleviate this, the statistics window can be closed.  When
  72. closed, it continues to accumulate information but does not write it to the
  73. offscreen window.  When you click the "Show" button to bring the window back
  74. onscreen it redisplays the entire window and the accumulated values show up.
  75. The icon, of course, always displays the statistic it has been selected for
  76. (of course, since it's normally a much smaller window this takes much less
  77. time).
  78.  
  79. I've found it very interesting to watch how different applications use up
  80. the machine.  Hopefully with this application people (both NeXT and third-
  81. party vendors) can do a better job of optimizing the impact their programs
  82. have on the system.
  83.  
  84. P.S.  Remember to set its group to kmem and do a "chmod g+s Monitor" after
  85.       you install it.
  86. --
  87. Roy J. Mongiovi     Systems Support Specialist     Office of Computing Services
  88. Georgia Institute of Technology      Atlanta, Georgia  30332-0275   (404) 894-4660
  89.     uucp: ...!{allegra,amd,hplabs,ut-ngp}!gatech!prism!roy
  90.     ARPA: roy@prism.gatech.edu
  91.