[0m


TOP(1)		    UNIX Programmer's Manual		   TOP(1)



[1mNAME
     [0mtop - display and update information about the top cpu
     processes

[1mSYNOPSIS
     top [0m[ [1m-s[0m_t_i_m_e ] [ _n_u_m_b_e_r ]

[1mDESCRIPTION
     [0m_T_o_p displays the top 10 processes on the system and periodi-
     cally updates this information.  It uses raw cpu percentage
     to determine the top processes.  The _c_u_r_s_e_s(3) package is
     used to do semi-optimal screen updating.  If _n_u_m_b_e_r is
     given, then the top _n_u_m_b_e_r processes will be displayed
     instead of the default amount of 10.  The [1m-s [0moption sets the
     delay between screen updates to _t_i_m_e seconds.  The default
     delay between updates is 5 seconds.

     The top few lines of the display show general information
     about the state of the system, including the last process id
     assigned to a process, the three load averages, the current
     time, the number of existing processes, the number of
     processes in each state (sleeping, ABANDONED, running,
     starting, zombies, and stopped), and a percentage of time
     spent in each of the processor states (user, nice, system,
     and idle).

     The remainder of the screen displays information about indi-
     vidual processes.	This display is similar in spirit to
     _p_s(1) but it is not exactly the same.  PID is the process
     id, USERNAME is the name of the process's owner, PRI is the
     current priority of the process, NICE is the nice amount (in
     the range -20 to 20), SIZE is the total size of the process
     (text, data, and stack), RES is the current amount of
     resident memory (both SIZE and RES are given in kilobytes),
     STATE is the current state (one of "sleep", "WAIT", "run",
     "idl", "zomb", or "stop"), TIME is the number of system and
     user cpu seconds that the process has used, WCPU is the
     weighted cpu percentage (this is the same value that _p_s(1)
     displays as CPU), CPU is the raw percentage and is the field
     that is sorted to determine the order of the processes, and
     COMMAND is the name of the command that the process is
     currently running (if the process is swapped out, this
     column is marked "<swapped>").

[1mNOTES
     [0mThe "ABANDONED" state (known in the kernel as "SWAIT") was
     abandoned, thus the name.	A process should never end up in
     this state.

[1mAUTHOR
     [0mWilliam LeFebvre, Rice University graduate student




Printed 22/10/92    Revision 1.1 of 15/12/89			1






TOP(1)		    UNIX Programmer's Manual		   TOP(1)



[1mFILES
     [0m/dev/kmem	    kernel memory
     /dev/mem	    physical memory
     /vmunix	    system image

[1mBUGS
     [0mThe command name for swapped processes should be tracked
     down, but this would make the program run slower.

     As with _p_s(1), things can change while _t_o_p is collecting
     information for an update.  The picture it gives is only a
     close approximation to reality.

[1mSEE ALSO
     [0mps(1), mem(4)








































Printed 22/10/92    Revision 1.1 of 15/12/89			2



[0m