home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / mint / mntutl95.lzh / MNTUTL95 / TOP.DOC < prev    next >
Text File  |  1993-08-03  |  5KB  |  139 lines
  1. NAME
  2.     top - repeatedly display system status
  3.  
  4. SYNOPSYS
  5.     top [-i] [-s seconds] [-w width] [-n nlines]
  6.  
  7. DESCRIPTION
  8.  
  9. "Top" is a program displays a periodically-updated picture of what's going
  10. on in your system.
  11.  
  12. The display is a snapshot of system activity at periodic intervals. The top
  13. line of the display shows the number of milliseconds included in the
  14. interval, the percentage of that time not accounted for in the running
  15. times of processes listed (idle time), the number of processes, the number
  16. of running processes, and the total number of bytes used (the sum of the
  17. memory sizes of the processes listed).
  18.  
  19. Below that each process in the system is listed, one per line.
  20. The fields of this line have the following meanings:
  21.  
  22.     PID    The process ID of this process
  23.  
  24.     PPID    The process ID of the parent of this process.
  25.  
  26.     STATUS    The run state of the process: Wait, Sleep, Ready, Exit,
  27.         TSR, and Stop.  The Exit state means this process has
  28.         terminated, but its parent has not received its exit code. 
  29.         The Ready state includes the Run state.
  30.  
  31.     SIZE    The amount of memory allocated to this process.
  32.  
  33.     TIME    The amount of time this process has run.  This is the sum
  34.         of the user and system times of the process, displayed as
  35.         MM:SS.FF (minutes, seconds, and fraction of a second) or
  36.         HH:MM:SS (hours, minutes, and seconds) if the process has
  37.         run one hour or more.
  38.  
  39.     %    The percentage of the time in this interval that this
  40.         process accounted for.
  41.  
  42.     COMMAND    The command this process is running.
  43.  
  44. The number of processes displayed is limited by the number of lines on
  45. your screen.
  46.  
  47. OPTIONS
  48.  
  49.     -s sleep
  50.         Set the interval between updates to 'sleep' seconds.
  51.         Default is 5.
  52.  
  53.     -w width
  54.         Set the maximum width of a line to 'width'.  The arguments
  55.         in the COMMAND field will be truncated so the line is no
  56.         more than 'width' characters long.  The rest of the display
  57.         (PID, STATUS, etc.) is not affected.  Default is the width
  58.         of your screen.
  59.  
  60.     -n nlines
  61.         Set the maximum number of processes to display.  This
  62.         defaults to the length of your screen minus three for
  63.         the status, input, and header lines.
  64.  
  65.     -i    interactive mode
  66.  
  67.         In Interactive mode the following single-key commands 
  68.         can be used:
  69.  
  70.         s    Prompt for the number of seconds between intervals.
  71.  
  72.         w    Prompt for the width; the width can be more than the
  73.             screen width, in which case long argument lists will
  74.             take up multiple lines.
  75.  
  76.         n    Prompt for the maximum number of processes to
  77.             display (nlines). This can be smaller than your
  78.             screen size, but not  larger.
  79.  
  80.         q    Quit.
  81.  
  82.         ^L    (control-L) clear and repaint the display.
  83.  
  84. NOTES
  85.  
  86. This program uses curses and termcap.  Appropriate environment variables
  87. must be set up.  The screen width and height, and thus the wraparound point
  88. for wide lines and the maximum number of processes to display, are set at
  89. startup time.
  90.  
  91. The "snapshot of your system" really is a snapshot: if things are moving
  92. too fast, you can get blur.  If a process appears, runs, and exits during a
  93. single interval, top will never see it, and the time it took to run will
  94. appear as "idle" time, because it's not accounted for by the running times
  95. of the processes top did see.  In fact, any time a process exits, its
  96. running time during the last interval appears as idle time.  Also, a
  97. process ("A") can appear in the list along with another process ("B") which
  98. can only have started after "A" exited (e.g. if make is running, a link
  99. process can appear on the same list with an assembler process which
  100. produced the linker's input).  Finally, the sum of the percentages might be
  101. greater than 100.  All this is caused by strobe, roundoff, and nonzero
  102. shutter time effects.
  103.  
  104. MiNT NOTES
  105.  
  106. Interactive mode is slower, which is why it isn't the default.  It's slower
  107. because it uses Fselect to sleep while waiting for keyboard input, rather
  108. than using Talarm and Pause, and Fselect sits in a loop with Syield rather
  109. than truly blocking.  MiNT 0.9 is said to fix this.
  110.  
  111. The Ready state includes the Run state: since top itself is always the
  112. running process when it gets a chance to check, having a separate name for
  113. it conveys no information.
  114.  
  115. The COMMAND field is the concatenation of the "name" field of the process
  116. and the command-line arguments in the process' basepage.  It can be wildly
  117. inaccurate if the process is using its basepage as its DTA for a directory
  118. search.
  119.  
  120. Processes are shown in the order they arrived from the directory search. If
  121. there are more processes than lines on your screen (or your nlines value),
  122. you'll see the older, less-interesting ones and lose the newer-more
  123. interesting ones off the bottom.
  124.  
  125. Top sometimes gets a bus error; this could be a problem related to
  126. operating on processes which don't exist any more.  MiNT might have to keep
  127. a process around if any other process has it open (i.e. has Fopen'ed the
  128. process on drive X:).
  129.  
  130. AUTHOR
  131.  
  132. Top for MiNT was written in August, 1991 by Allan Pratt, Atari Corp.
  133. (atari!apratt).  The idea for top came from the program of that name for
  134. BSD UNIX systems. (UNIX is a trademark of AT&T.)  The source code is a
  135. hacked-over version of ps, written in March of 1991 by Tony Reynolds
  136. (cctony@sgisci1.ocis.olemiss.edu) and modified by Eric Smith (Mr. MiNT
  137. himself).
  138.  
  139.