man/man1/top.1

   1 .TH TOP 1
   2 .SH NAME
   3 top \- show processes sorted by CPU usage
   4 .SH SYNOPSIS
   5 .B top
   6 .SH DESCRIPTION
   7 Top displays a list of all running processes, once every update interval
   8 (currently 5 seconds). It is sorted by the CPU usage of the processes in
   9 the last interval. The first display is the CPU usage of processes since
  10 the boot time.
  11
  12 At the top of the screen, top shows the current system load averages in
  13 the last 1-minute, 5-minute and 15-minute intervals. Then, over the
  14 last top interval it displays: the number of alive, active, and sleeping
  15 processes; memory free; and CPU usage. CPU usage is split into
  16 user, kernel, system and idle time. Kernel time is time spent by kernel tasks,
  17 that is tasks that run in kernel mode in kernel address space. System
  18 time are system user processes, such as drivers and servers. User
  19 time is all other CPU time.
  20
  21 Then it displays all the alive processes sorted by CPU usage in the last
  22 interval, with a number of fields for every process. Currently the
  23 following fields are displayed:
  24 .PP
  25   PID
  26     The process id of the process. Some processes (so-called kernel
  27     tasks) don't have a real process id, as they are not processes
  28     that are managed by the process manager, and aren't visible to
  29     other user processes by pid. They are shown by having their process
  30     slot number in square brackets.
  31   USERNAME
  32     The username of the effective uid at which the process runs,
  33     or a number if the username could not be looked up.
  34   PRI
  35     The system scheduling priority the process is currently running as.
  36     A lower priority number gives a higher scheduling priority. The
  37     lowest is 0. The scale is internal to the kernel.
  38   NICE
  39     The base scheduling priority the process has been given at startup.
  40     0 is normal for a regular user process; the range is -20 to 20
  41     (PRIO_MIN and PRIO_MAX in <sys/resource.h>. Most system processes
  42     are given higher base priorities.
  43   SIZE
  44     Text + data size in kilobytes.
  45   STATE
  46     RUN if the process is runnable, empty if blocking.
  47   TIME
  48     Total number of CPU time spent in the process itself. So-called
  49     system time (CPU time spent on behalf of this process by another
  50     process, generally a system process) is not seen here.
  51   CPU
  52     Percentage of time that the process was running in the last interval.
  53   COMMAND
  54     Name of the command that belongs to this process.
  55
  56 .SH "SEE ALSO"
  57 .BR ps (1)
  58 .SH BUGS
  59 This is a from-scratch reimplementation of top for MINIX 3.
  60 Many features (such as interactive commands) are not implemented.
  61 Sorting is only done by CPU usage currently. Displayed state is
  62 only RUN or empty.
  63 .SH AUTHOR
  64 Ben Gras (beng@few.vu.nl)