version 1.44, 2007/02/14 08:29:28 |
version 1.45, 2007/03/15 22:02:22 |
|
|
.Nd display and update information about the top CPU processes |
.Nd display and update information about the top CPU processes |
.Sh SYNOPSIS |
.Sh SYNOPSIS |
.Nm top |
.Nm top |
|
.Bk -words |
.Op Fl bCIinqSTu |
.Op Fl bCIinqSTu |
.Op Fl d Ar count |
.Op Fl d Ar count |
.Op Fl g Ar command |
.Op Fl g Ar string |
.Op Fl o Ar field |
.Op Fl o Ar field |
.Op Fl p Ar pid |
.Op Fl p Ar pid |
.Op Fl s Ar time |
.Op Fl s Ar time |
.Op Fl U Ar username |
.Op Fl U Ar user |
.Op Ar number |
.Op Ar number |
|
.Ek |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm |
.Nm |
displays the top processes on the system and periodically updates this |
displays the top processes on the system and periodically updates this |
|
|
automatically exits. |
automatically exits. |
For intelligent terminals, no upper limit is set. |
For intelligent terminals, no upper limit is set. |
The default is 1 for dumb terminals. |
The default is 1 for dumb terminals. |
.It Fl g Ar command |
.It Fl g Ar string |
Show only processes that contain the string |
Display only processes that contain |
.Ar command |
.Ar string |
in their command name. |
in their command name. |
.It Fl I |
.It Fl I |
Do not display idle processes. |
Do not display idle processes. |
|
|
.Em batch |
.Em batch |
mode. |
mode. |
.It Fl o Ar field |
.It Fl o Ar field |
Sort the process display area using the specified field as the primary key. |
Sort the process display area using the specified |
|
.Ar field |
|
as the primary key. |
The field name is the name of the column as seen in the output, |
The field name is the name of the column as seen in the output, |
but in lower case. |
but in lower case. |
The |
The |
|
|
Show process threads in the display. |
Show process threads in the display. |
Normally, only the main process is shown. |
Normally, only the main process is shown. |
This option makes all threads visible. |
This option makes all threads visible. |
.It Fl U Ar username |
.It Fl U Ar user |
Show only those processes owned by |
Show only those processes owned by |
.Ar username . |
.Ar user . |
This option currently only accepts usernames and will not understand |
This option currently only accepts usernames and will not understand |
UID numbers. |
UID numbers. |
.It Fl u |
.It Fl u |
|
|
.Ar count |
.Ar count |
processes. |
processes. |
.It o Ar field |
.It o Ar field |
Change the sorting order of the processes, selected by |
Sort the process display area using the specified |
.Ar field . |
.Ar field |
|
as the primary key. |
Values are the same as for the |
Values are the same as for the |
.Fl o |
.Fl o |
flag, as detailed above. |
flag, as detailed above. |
.It p Ar pid |
.It p Ar pid |
Display a specific process, selected by |
Show only the process |
.Ar pid . |
.Ar pid . |
.Sq p+ |
.Sq p+ |
shows all processes. |
shows all processes. |
|
|
.It T |
.It T |
Toggle the display of process threads. |
Toggle the display of process threads. |
.It u Ar user |
.It u Ar user |
Display only processes owned by a specific |
Show only those processes owned by |
.Ar user . |
.Ar user . |
.Sq u+ |
.Sq u+ |
shows processes belonging to all users. |
shows processes belonging to all users. |