home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-Update.iso / NEXTSTEP / unix / admin / top.0.5.README < prev    next >
Encoding:
Text File  |  1997-02-08  |  9.5 KB  |  220 lines
  1.  
  2.                              TOP v3.3
  3.                    Version 0.5 for NEXTSTEP
  4.  
  5. Unix utility to monitor process usage and system statistics in a terminal window.
  6.  
  7. Warning:  For general use, top must have suid status for the file's owner, root, which could be a security problem for some sites.
  8.  
  9. KNOWN PROBLEMS AND FIXES:
  10.  
  11. NEXTSTEP - v0.5  11/26/96 tpugh
  12. 1) Fixed missing command name for every process when running top on OPENSTEP 4.1 Black hardware.  Problem occurred due to a kernal task data structure change.
  13.  
  14. NEXTSTEP - v0.4   2/29/96 tpugh
  15. 1) Second attempt to eliminated the text artifact in the command column.
  16. 2) When quiting the program, a message "nobody" was printed and the cursor was not placed at the bottom of the screen.  The hash_table was corrupting memory when hashit(uid=-2) = -2 or any negative number.
  17. 3) Fixed incorrect load average display.  Incorrect scaling of the kernel load average fixed-point values.
  18.  
  19.  
  20. NEXTSTEP - v0.3  2/15/96 tpugh
  21. This release fixes the problems in release v0.2.
  22. 1)  Command name not showing in the display.  This problem occurs for hppa and sparc machines, and NS4.0 alpha machines.  NeXT changed the task structure, so top could not find utask structure which contains the command name.  <mach/task.h> is not shipped with any NEXTSTEP systems.
  23. 2) Removed all C++ style comments from machine.c to be ANSI C compatible.
  24. 3) Removed the %WCPU field, no support for it.
  25. 4) Reduced line length to less than 80 columns.  Some commands are long and will extend beyond 80 colums.
  26. 5) Fixed "top -U" fails with bus error.  In special cases where only a specific user is displayed, the process index variable was being improperly advanced, resulting in zero process address values and bus errors.
  27. 6) Eliminated the text artifact in the command column.
  28.  
  29.  
  30. NEXTSTEP - v0.2  9/1/95 tpugh 
  31. This release fixes two problems.
  32. 1) new processes were not showing up in the display.
  33. 2) compiling problems.  The compiler flags are now correctly inserted into the makefile without user action.  Continue to use the Configure script to setup and install the software.  When it asks for compiler flags, use the defaults listed.
  34.  
  35.  
  36. NEXTSTEP - v0.1  8/2/95 tpugh
  37. This is the first release for NEXTSTEP, so beware.  It's working nicely on my NeXTstation Turbo Color running NEXTSTEP v3.2.
  38.  
  39. Please let me know of any problem so we can fix them.  Let me know if it works.
  40.  
  41.     Tim Pugh
  42.     Oregon State University
  43.     tpugh@oce.orst.edu
  44.  
  45.  
  46. COMPATIBILITY - next32
  47. This is the machine-dependent module for NEXTSTEP v3.x
  48. Reported to work for NEXTSTEP v3.0, v3.2, and v3.3 Mach OS:
  49.     NEXTSTEP v3.0 on Motorola machines.
  50.     NEXTSTEP v3.2 on Intel and Motorola machines.
  51.     NEXTSTEP v3.3 on Intel and Motorola machines.
  52. Problem with command column for (Choose next40 for fix):
  53.     NEXTSTEP v3.2 on HP machines.
  54.     NEXTSTEP v3.3 on HP and Sparc machines.
  55. Has not been tested for NEXTSTEP v2.x machines, although it should work.
  56. Has not been tested for NEXTSTEP v3.1 machines, although it should work.
  57.  
  58. COMPATIBILITY - next33
  59. This is the machine-dependent module for NEXTSTEP v3.x
  60. Reported to work for:
  61.     NEXTSTEP v3.2 on HP machines.
  62.     NEXTSTEP v3.3 on HP and Sparc machines.
  63.  
  64.  
  65. COMPATIBILITY  -  next40
  66. This is the machine-dependent module for NEXTSTEP v4.x
  67. Reported to work for NEXTSTEP v4.x Mach OS:
  68.     NEXTSTEP v4.0 on NeXTstation machines.
  69.     NEXTSTEP v4.1 on NeXTstation machines.
  70. Has not been tested for NEXTSTEP v4.x Intel or SPARC machines.
  71.  
  72.  
  73. FREQUENTLY ASKED QUESTIONS
  74.  #1:   top 3.3 (after configuring for next32 with all defaults) on my i386 running NEXTSTEP 3.3, I get:  Error calling task_by_unix_pid(): failure(5)
  75.  
  76. The call is failing because you do not have permission.  You must be the superuser, root, or the program must have root privledges to work properly.  It's been reported that setting the group sticky bit for kmem does not work, and the fix is to set the user sticky bit for root.  So install "top" with the permissions 4755.
  77.  
  78. As root, do the following:
  79. tsunami# chown root.kmem top
  80. tsunami# chmod 4755 top
  81. tsunami# ls -lg top
  82. -rwsr-xr-x  1 root     kmem      121408 Sep  1 10:14 top*
  83.  
  84. With the kmem group sticky bit set, we can read kernal memory without problems, but to communicate with the Mach kernal for task and thread info, it requires root privileges.
  85.  
  86.  
  87. #2:  How to compile top to create a multiple binary file or FAT?
  88.  
  89. Add the -arch <machine> flags to line 64 of the Makefile.  i.e.
  90. CFLAGS = -DSHOW_UTT -arch m68k -arch i386 -arch hppa -arch sparc $(CDEFS)
  91.  
  92. Add $(CFLAGS) to line 79 of the Makefile. i.e.
  93.     $(CC) $(CFLAGS) -o top $(OBJS) -ltermcap -lm $(LIBS)
  94.  
  95.  
  96. #3:  I installed 'top' chmod 4711, chown root.kmem, but cannot use the '-q' 
  97. flag unless I am logged in as 'root'
  98.  
  99. "top: warning: `-q' option can only be used by root"
  100.  
  101. This seems to indicate that the setuid to root isn't being recognized 
  102. correctly.
  103.  
  104. In order to run top with the "-q" command, top currently requires the user to be logged in a root because top checks the uid of the user logged in, not the effective uid of the file. Why?  To not allow a regular users to swamp the system with a high-priority process. Imagine what a regular user could do with "top -q -s0 all"!
  105.  
  106.  
  107.  
  108. ===============================================================================
  109.  
  110.  
  111.                              TOP
  112.                          Version 3.3
  113.  
  114.                        William LeFebvre
  115.                      and a cast of dozens
  116.  
  117.  
  118. If you do not want to read this entire file, then at least read
  119. the section at the end entitled "KNOWN PROBLEMS".
  120.  
  121. "top" is a program that will give continual reports about the state of
  122. the system, including a list of the top cpu using processes.  Version 3
  123. of "top" has three primary design goals: provide an accurate snapshot of
  124. the system and process state, not be one of the top processes itself, be
  125. as portable as possible.
  126.  
  127. Version 3 has many bug fixes from version 2.5, and it has also been
  128. reorganized in a major way to make it easy to port to other platforms.
  129. All system dependent code is now contained in one file.
  130.  
  131. Top now includes a configuration script called "Configure".  It helps
  132. the installer choose the correct parameters for this particular
  133. installation.  This script MUST be run before attempting to compile top.
  134.  
  135. Top requires read access to the memory files "/dev/kmem" and "/dev/mem"
  136. as well as the system image "/vmunix".  Some installations have these
  137. files protected from general access.  These sites would have to install
  138. this program in the same way that programs such as "ps" are installed.
  139. In addition, on those Unix variants that support the proc filesystem
  140. (such as SVR4 and Solaris 2), top requires read access to all the files
  141. in /proc: typically dictating that top be installed setuid to root.
  142.  
  143. CAVEAT: version 3 of top has internal commands that kill and renice
  144. processes.  Although I have taken steps to insure that top makes
  145. appropriate checks with these commands, I cannot guarantee that these
  146. internal commands are totally secure.  IF YOU INSTALL top as a SETUID
  147. program, you do so AT YOUR OWN RISK!  I realize that some operating
  148. systems will require top to run setuid, and I will do everything I can
  149. to make sure that top is a secure setuid program.
  150.  
  151. Configure will ask you to input values for certain parameters.  Before
  152. each parameter, Configure will display a description of what the
  153. parameter does.  Read the description and choose an appropriate value.
  154. Sometimes a default will appear in brackets.  Typing just return will
  155. choose the default.
  156.  
  157. System support now takes the form of "modules".  Adding support for
  158. a different architecture requires only adding a module.  Configure
  159. asks which module to use when it is configuring top.  See the file
  160. "Porting" for a description of how to write your own module.
  161.  
  162. To compile and install "top", read the file "INSTALL" and follow the
  163. directions and advice contained therein.
  164.  
  165. Once you have created a binary for one particular type of machine, you
  166. can reconfigure for another type with "./Configure modulename" where
  167. "modulename" is replaced with the appropriate module name.  All other
  168. parameter values are kept the same.  Note that in some cases this may
  169. not be appropriate.
  170.  
  171. If you make any kind of change to "top" that you feel would be
  172. beneficial to others who use this program, or if you find and fix a bug,
  173. please send me the change.
  174.  
  175. Be sure to read the FAQ enclosed with the distrubution.  It contains
  176. answers to the most commonly asked questions about the configuration,
  177. installation, and operation of top.
  178.  
  179. AVAILABILITY
  180.  
  181. The latest version of "top" is always available via anonymous FTP from
  182. the host "eecs.nwu.edu" in the directory "/pub/top".  Additional modules
  183. will be made available in the directory "/pub/top/m".
  184.  
  185. KNOWN PROBLEMS:
  186.  
  187. DECOSF/1 V3.0
  188.  
  189. There is a bug either in the module, in utils.c, or in DEC's optimizer that
  190. is tickled by the decosf1 module when compiled under V3.0 (and perhaps
  191. earlier versions).  Top compiled using DEC's compiler with optimization
  192. will consistently produce a segmentation fault (in format_next_process
  193. while calling sprintf).  To work around this problem, either compile top
  194. with gcc or turn off optimization (compile without -O).  Hopefully someone
  195. out there will be able to tell me why this is happening.
  196.  
  197. Gnu CC
  198.  
  199. See the file "FAQ":  question #11.
  200.  
  201.  
  202. System V R 4.2
  203.  
  204. Load average and memory displays do not work.  The problem has been
  205. traced down to a potential bug in the "mem" driver.  The author
  206. of the svr42 module is working on a fix.
  207.  
  208.  
  209.         William LeFebvre
  210.         Decision and Information Sciences
  211.         Argonne National Laboratory
  212.         lefebvre@dis.anl.gov
  213.  
  214.  
  215.         U.S. Mail address:
  216.             William LeFebvre
  217.             9700 South Cass Avenue
  218.             DIS/900
  219.             Argonne, IL  60439
  220.