version 1.25, 2004/10/07 06:26:12 |
version 1.26, 2005/05/13 20:43:30 |
|
|
This mode is the default when standard output is an intelligent terminal. |
This mode is the default when standard output is an intelligent terminal. |
.It Fl I |
.It Fl I |
Do not display idle processes. |
Do not display idle processes. |
By default, top displays both active and idle processes. |
By default, |
|
.Nm |
|
displays both active and idle processes. |
.It Fl n |
.It Fl n |
Use |
Use |
.Em non-interactive |
.Em non-interactive |
|
|
but in lower case. |
but in lower case. |
The |
The |
.Ox |
.Ox |
version of top supports |
version of |
|
.Nm |
|
supports |
.Ar cpu , |
.Ar cpu , |
.Ar size , |
.Ar size , |
.Ar res , |
.Ar res , |
|
|
.It Fl q |
.It Fl q |
Renice |
Renice |
.Nm |
.Nm |
to -20 so that it will run faster. |
to \-20 so that it will run faster. |
This can be used when the system is |
This can be used when the system is |
being very sluggish to improve the possibility of discovering the problem. |
being very sluggish to improve the possibility of discovering the problem. |
This option can only be used by root. |
This option can only be used by root. |
|
|
.Fl o |
.Fl o |
flag, as detailed above. |
flag, as detailed above. |
.It p |
.It p |
Display a specific process (prompt for pid). |
Display a specific process (prompt for PID). |
If the pid specified is simply |
If the PID specified is simply |
.Dq + , |
.Dq + , |
then processes belonging to all users will be displayed. |
then processes belonging to all users will be displayed. |
.It r |
.It r |
Change the priority (the |
Change the priority (the |
.Em nice ) |
.Em nice ) |
of a list of processes. |
of a list of processes (prompt for the new nice value and the list of |
|
PIDs, all separated by space). |
This acts similarly to the command |
This acts similarly to the command |
.Xr renice 8 . |
.Xr renice 8 . |
.It s |
.It s |
|
|
the current time, |
the current time, |
the number of existing processes, |
the number of existing processes, |
the number of processes in each state |
the number of processes in each state |
(sleeping, running, starting, zombies, and stopped), |
(starting, running, idle, stopped, zombie, dead, and on processor), |
and a percentage of time spent in each of the processor states |
and a percentage of time spent in each of the processor states |
(user, nice, system, and idle). |
(user, nice, system, interrupt, and idle). |
It also includes information about physical and virtual memory allocation. |
It also includes information about physical and virtual memory allocation. |
The load average numbers give the number of jobs in the run queue averaged |
The load average numbers give the number of jobs in the run queue averaged |
over 1, 5 and 15 minutes. |
over 1, 5, and 15 minutes. |
.Pp |
.Pp |
The remainder of the screen displays information about individual |
The remainder of the screen displays information about individual |
processes. |
processes. |
This display is similar in spirit to |
This display is similar in spirit to |
.Xr ps 1 |
.Xr ps 1 |
but it is not exactly the same. |
but it is not exactly the same. |
PID is the process ID, USERNAME is the name |
The following fields are displayed: |
of the process's owner (if |
.Bl -tag -width USERNAME -offset indent |
|
.It PID |
|
The process ID. |
|
.It USERNAME |
|
The name of the process's owner. |
|
.It UID |
|
Used instead of USERNAME if |
.Fl u |
.Fl u |
is specified, a UID column will be substituted for USERNAME), |
is specified. |
PRI is the current priority of the process, |
.It PRI |
NICE is the nice amount (in the range -20 to 20), |
The current priority of the process. |
SIZE is the total size of the process (text, data, and stack), |
.It NICE |
RES is the current amount of resident memory (both SIZE and RES are |
The nice amount (in the range \-20 to 20). |
given in kilobytes), |
.It SIZE |
STATE is the current state (one of |
The total size of the process (the text, data, and stack segments). |
.Li sleep , |
Given in kilobytes. |
.Li WAIT , |
.It RES |
|
The current amount of resident memory. |
|
Given in kilobytes. |
|
.It STATE |
|
The current state (one of |
|
.Li start , |
.Li run , |
.Li run , |
.Li idl , |
.Li sleep , |
|
.Li stop , |
|
.Li idle , |
.Li zomb , |
.Li zomb , |
|
.Li dead , |
or |
or |
.Li stop ) , |
.Li onproc ) . |
TIME is the number of system and user CPU seconds that the process has used, |
On multi-processor systems, this is followed by a slash and the CPU |
WCPU, when displayed, is the weighted CPU percentage (this is the same |
number on which the process is bound. |
value that |
.It WAIT |
.Xr ps 1 |
A description of the wait channel the process is sleeping on if it's |
displays as CPU), |
asleep. |
CPU is the raw percentage and is the field that is sorted to determine |
.It TIME |
the order of the processes, and |
The number of system and user CPU seconds that the process has used. |
COMMAND is the name of the command that the process is currently running |
.It CPU |
(if the process is swapped out, this column is marked |
The raw percentage of CPU usage and the default field on which the |
.Li <swapped> ) . |
display is sorted. |
.Sh NOTES |
.It COMMAND |
The |
The name of the command that the process is currently running. |
.Em ABANDONED |
(If the process is swapped out, this column is enclosed by angle |
state (known in the kernel as |
brackets.) |
.Em SWAIT ) |
.El |
was abandoned, thus the name. |
|
A process should never end up in this state. |
|
.Sh ENVIRONMENT |
.Sh ENVIRONMENT |
.Bl -tag -width XxXXXX |
.Bl -tag -width Ev |
.It Ev TOP |
.It Ev TOP |
User-configurable defaults for options. |
User-configurable defaults for options. |
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width XxXXXXXXX -compact |
.Bl -tag -width Pa -compact |
.It Pa /dev/kmem |
.It Pa /dev/kmem |
kernel memory |
kernel memory |
.It Pa /dev/mem |
.It Pa /dev/mem |
physical memory |
physical memory |
|
.It Pa /etc/passwd |
|
used to map user ID to name |
.It Pa /bsd |
.It Pa /bsd |
kernel image |
kernel image |
.El |
.El |
|
|
.Sh AUTHORS |
.Sh AUTHORS |
William LeFebvre, EECS Department, Northwestern University |
William LeFebvre, EECS Department, Northwestern University |
.Sh BUGS |
.Sh BUGS |
The command name for swapped processes should be tracked down, but this |
|
would make the program run slower. |
|
.Pp |
|
As with |
As with |
.Xr ps 1 , |
.Xr ps 1 , |
things can change while |
things can change while |