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